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ABSTRACT 



Interactive computer systems have traditionally 
communicated with the sophisticated computer user through a 
precise computer language. That language involved numerous 
control structures. Hardware costs and technology trends 
have excited a new breed of computer user. Theyf however^ 
have lacl«:ed the sophistication and technical background to 
use most of the currently designed computer systems. In an 
attempt to meet the needs of the new breed of computer-naive 
userf The Rand Corporation has developed the Rule-directed 
Interactive Transaction Agent (RITA) system. RITA has used 
production systems and an English-like grammar to simplify 
program control structures and to communicate with the 
computer-naive user in a language of familiarity. A 
tutorial document has been developed to support the 
computer-naive user in using the RITA system. 
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I . INTPODUCTIQN 



As the PODulation of computer users has continued to 
rise and the costs of computer hardware have declinedr 
developers of computer hardware and software have prepared 
to meet the challenae of a new breed of comouter user. That 
user was well versed in the responsibilities of his job and 
needed a computer to accomplish his tasks more efficiently 
and economically. Howeverr the new breed of computer user 
was not a ^computer sophisticate.” He viewed the computer 
as a tool to accomplish a job. The user was neither a 
technical person nor an abstract thinker. His language was 
English^ not Fortran or Cobol. 

To reach the new breed of computer userr the language of 
interaction with the computer must have been easy to use and 
very Eng 1 i sh - 1 i ke . The language must have contained very 
fewf if anyf fancy control structures. It must have allowed 
the user to write computer programs in the same natural way 
as he has thought about a problem. 

The Rand Corporationr in a research grant sponsored by 
the Defense Advanced Research Projects Agency (DARPA)f has 
developed a computer language with an operating environment 
in which programs can be written to perform a variety of 
tasks. The language and its operating environment have been 
called RITA (Rule-directed Interactive Transaction Agent.) 

RITA has met the neeas of the new breed of computer user 
by having an English-like Grammar and only one primary 
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control structure^ oroduction rules. 

The ouroose of this research was to describe a 
particular production rule system (RITA) and to develop a 
tutorial document to introduce the computer-naive user to 
that system. The ** c orr pu t e r -n a i v e ” user^ as discussed in 
this reoortf has little cr no computer experience/ has a 
limited technical backgrounds and must interact with a 
C ompu ter. 
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I I . BACKGROUND 



The Rule-directed Interactive Transaction Aqent (RITA), 
a set of corpputer programs written in the programming 
language^ was developed on a POP-11/^5 minicomputer. The 
programs were developed to perform a variety of user tasks# 
both under direct user control or semiautonomously over 
extended periods of time. Among these tasks were (1) 
handling and modifying data on local storage files# (2) 
communicating interactively with external information 
systems over telephone lines or the ARPANET# (3) providing 
local instructional information and error-checking of input 
data# and (^) heuristic modeling of a limited set of 
relationships [Anderson and Gillogly# 1976]. 

For a system to meet the needs of the computer-naive 
user# several criteria were necessary. The criteria for the 
system were (1) be capable of explaining its behavior upon 
request# (2) be capable of having its behavior modified by 
the user# (3) be controlled by a set of heuristics stated as 
rules# rather than as formal algorithms# and (^) retain a 
memory of tasks assigned# progress# schedules# and 
deadlines* A fifth reauirement of the system# although only 
implied# was that the RITA system must communicate with the 
user in a natural language# such as English [Anderson and 
Gi 1 logly# 1976] . 

To meet the designers’ reauirements# the RITA system 
used production systems. Production systems are sets of 
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predicate - action rules (If - Then rules) operating on 
database under the direction of a rule interpreter 
mon i t o r . 
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III. DESIGN 



A. PRODUCTION SYSTEMS 

A production system is a collection of rules of the form 
conditions actions (Newell and Simonr 197^]# where the 
conditions are statements about the contents of a data base 
and the actions are procedures which may hav/e modified the 
contents of that data base. The production system checks 



the data 


base 


to determine if 


the 


condi t ions 


o f 


the 


produc t i on 


rule 


are t rue . When 


the 


conditions 


o f 


the 



production rule are true# all the actions associated with 
the true rule are performed. The production rule system 
continues to check the conditions of the production rules 
and performs the actions of the true rules until the 
conditions for all the production rules are false or a 
special halting action is executed (Waterman# 1R76J. 

The execution of the production rules was based upon the 
contents of the data base. These Production rules caused 
the sequence of program execution to depend completely upon 
the contents of the data base. Typical computer programs 
executed sequentially or have had explicit knowledge about 
where code will next be executed in the program (Waterman# 
19761 . 

Production systems# because of the method of program 
execution# have provided a simple and uniform way of 
handling control flow and data management in programs which 
exhibit intelligent behavior. They have been particularly 



useful for developing programs which can 



learn 



f r om 



experience# i.e.# which can demonstrate adaptive behavior 
[Waterman# 19761 • 

Proauction systems have fallen into two general classes. 
The first class was the conventional condition-driven one in 
which the conditions of a production rule were compared to 
the contents of the data base. Based upon the determination 
that all the conditions of the production rule were true# 
the appropriate actions were performed. Several systems 
have used this scheme [Newell and Simon# 1972; Newell# 1973; 
Waterman# 1975) . 

The second class of production systems interacted with 
the data base through the actions of a production rule 
[Shortliffe and others# 1975; Davis# 19761. The action- 
driven systems have production rules analogous to logical 
implication statements# i.e.# A & B --> C# means that if A 
and B are true then C is true. The action-driven system 
would try to show that C was true by looking for C in the 
data base. Items were only in the data base if they were 
true. If that failed# then the action-driven system would 
attempt to show that A and 8 were true. If A and B were 
true# then C was true and would be put into the data base 
[Waterman# 19761 • 

The condi ton-driven production system and the action- 
driven production system were incorporated into the RITA 
design and implementation. The condition -driven production 
system provided the flexibility necessary for a system 
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requiring a dynamic data base. The action-driven production 
system orovided the ability to answer user questions through 
deductive inference. 

Examples of both classes of production systems are shown 
below. In these examples^ data base elements are letters 
and are considered true if they are in the data base. The 
first example is that of a cond i t i on-dr i ven production 
system. 



DATA BASE: B 

RULES: 1 . A --> C 

2. B --> A 



The conditions of Rule 1 were tested. The element A was 
not in the data baser so Rule 1 was false. The conditions 
oT Rule 2 were tested. Since the element B was in the data 
baser Rule 2 was true. The actions of Rule 2 were 
performed. Element A became a member of the data base. The 
procedure began again and tested Rule 1. The element A was 
now in the data base. Rule 1 was true and the actions were 
performed. The element C was put into the data base. For 
purposes of the example# assume Rule 1 had a special halting 
action. The condition-driven system stopped testing rules 
as a result of the special halting action in Rule 1. The 
data base has been modified by the testing and execution of 
the two rules in the example. The data base now contains 
three elements: A# B# anc C. 



The second example [Waterman 



19761 is that of an 



action-driven oroduction system, ^gain^ the data base 
elements in this example are letters and considered true if 
they are in the data base. 

DATA BASE: 0 





RULES: 


1 . A - 


-> c 


















2. B - 


-> A 


















3. C- 


-> 0 
















In this 


example 


r the 


goa 1 


was 


t o 


show that D 


was true. 


The 


system 


first 


c hec ked to 


see 


i f 


the data base 


con t a i ned 


the 


e 1 erne n t 


0 . The 


data 


base 


d i d 


not 


contain the 


el emen t 


D. 


The 


action 


”dr i ven 


system t 


r i ed 


t 0 


deduce D by 


using 


the 


rules that 


had 0 on 


the 


right 


-hand side. Rule 3 


had D 


on 


the 


right- 


hand side. 


The 


system checked Rule 3 


to see 


i f 


the 


e 1 emen t 


C was a 


part 


0 f 


the 


data base . It 


was 


not 


there. The system 


then 


checked 


the 


right-hand side of each 



rule to see if the element C was there. If the system could 
have found a rule that made element C truer then Rule 3 
could have been executed to make element D true. The system 
checked Rule I because element C was on the right-hand side. 
Rule 1 was not true. Element A was not part of the data 
base. The system then checked the rules that had element A 
on the right-hand side. Rule 2 was tested. It was true 
because element B was a part of the data base. Rule 2 was 
executed. Element A became a part of the data base. Rule 1 
was executed. Element C became part of the data base. Rule 
3 was then executed. Element D became a part o‘f the data 



la 



"■wh . 







base. The goal has been satisfied. Element D is now true. 

The action-driven system solved the oroblem by back- 
tracking to find a rule that was useful in causing the 
requested goal to be satisfied. The action-driven systemf 
as implemented in the RITA systemf would have prompted the 
user if the back-tracking process was not successful in 
solving the problem. The user could have then provided the 
necessary information to assist the ac t i on -d r i ven system in 
satisfying the goal. 

B. ENGLISH-LIKE LANGUAGE 

For the comouter user to successfully interact with a 
computerf the computer must be told what to do and the 
computer must understand the instructions (Weizenbaumf 
1^76]. The needs of the comout er-na i ve user and the 
computer have been in conflict. The computer-naive user has 
a need to communicate with a comouterr but has not 
understood the conventional computer languages. The 
computer-naive user has been best able to interact with the 
computer through a language of familiarityf the English 
language. But the English language has been less precise 
than most computer languages. The computer is unlikely to 
prepare a proper program unless its comprehension of the 
problem is entirely correct (Weizenbaumf 1976]. 

One of the most appealing aspects of the RITA system has 
been the near-English command language. The designers of 
the RITA system chose an English-like language for its broad 
appeal to the new user population. 
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C. INTELLIGENT TERMINAL 

The RITA language has been designed for broad-based user 
aODeal, The lanquage specified has been English-like and 
the basic control structures^ oroduction rules/ have the 
gualities of simolicity and eleaance. However/ the 
computer-naive user has neither the expertise nor the 
resources needed to maintain RITA as currently implemented 
on the PDP-11/45 minicomputer. 

The designers of the RITA system have felt that the 
acceptable alternative to the current hardware requirement 
was to develop an intellioent terminal [Anderson and 
Gillogly/ 1976). Hardware and software technology advances 
have indicated the feasibility of such a terminal. The 
intelligent terminal would provide a powerful tool at 
relatively low cost. 

The RITA system has been designed as a set of programs 
expected to reside in an intelligent terminal. The 
following observations concerning man/machine interaction 
and its supporting technologies have formed the basis for 
the research by The Rand Corporation into the area of 
intelligent terminals (Anderson and Gillogly/ 1976): 

1. The rapid decline in the cost of computer hardware 
and data communications has made the purchase of interactive 
computer-based information systems cost effective for a 
broad category of users. However/ the user will need 
assistance in tailoring the system to his specific needs and 
especially in freeing him from routine interaction and 
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orotocols not directly related to the performance of his 

j Ob . 



2. Projected computer hardware cost trends and advances 
in m i c r OP roc es so r technology make it extremely likely that 
interactive computer terminals can be produced prior to 1983 
containing processing power equivalent to a present-day 
minicomputer. 

3. The intelligent terminal could provide local 
information storage and handling capabilities. This 
service/ provided locally/ could yield high speed responses/ 
lower cost/ increased reliability/ and improved security. 
The immediacy of response (e.g./ to simple input error 
conditions) is the primary reason for advocating local 



p roc es s i ng 



I V . PITA IMPL EMFNTATTON 



A. SIMPLICITY OF PROGRAM WRITING 

The RITA system has been designed as a set of orograms 
that will eventually reside in an intelligent terminal and 
be used by computer-naive persons. The ability for the 
group of users to writer read/ and understand RITA programs 
were Ley goals of the implementation. 

The production systems provided simple program control. 
More importantly/ the user had to learn only one control 
structure to write RITA programs. Rules of the form - If a 
set of conditions are true/ Then perform a set of actions - 
comprised the entire RITA program. The following example 
demonstrates the character of the prociuction system as 
imolemented in RITA: 

(DATA BASE! 

OBJECT sh i p< 1 > : 

name is ”JFK*’/ 
type is ^Carrier"; 

OBJECT sh i p<2> : 

name is Sp r u anc e ** / 
type is Destroyer"? 

(RULE SET) 
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RULE one 



IF: there is a shio whose name is ”JFK” 

and whose port is not Wnown 
THEM: deduce the port of the ship; 

GOAL one: 

IF: there is a shio whose name is ’*JFK” 

THEN: set the port of the ship to ** Norfolk** 
and display object ship<l>; 

Information in the data base has been stored in objects. 
The objects have attributes and values. Object ship<l> has 
two attributes/ name and type. The value '*JFK” has been 
associated with the attribute name and the value "Carrier** 
has been associated with the attribute type. Object ship<2> 
has two attributes with associated values. 

Rule one has two concitions: Is there a ship whose name 

is ”JFK’*? and Is there a shio whose port is not known? Mot 
known indicates the element is not in the data base. Rule 
one has one action: Deduce the oort of the ship. Deduce 

has been implemented as a RITA command to start the action- 
driven production system. Goal one has one condition: Is 

there a ship whose name is "JFK”? Goal one has two actions: 
Set the port of the ship to ** Norfolk" and display object 
shio<l>. Set caused the information in the data base to be 
modified and display caused information to be printed at the 
user’s terminal. 

When this program was executed/ rule one was true. The 
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action part of rule one caused the deduction of the oort of 



the shio. The action-driven production systenn looked at the 
right-hand side of all the goals to determine the 
aooropriate goal to check. Goal one was tested and found to 
be true. The port of the shio was set to "Norfolk.** The 
deduction stopped because the Question "iA/hat is the port of 
the ship?*’ has been answered. The display command caused 
the object ship<l> to be printed at the terminal in the 
following manner: 

OBJECT sh i p< 1 > 

name is "JFK% 
type is ** Carrier*'# 
port is "Norfolk"; 

The structure of the RITA syntax has been designed to be 
s t r a i gh t - f o r wa r d . The Enqlish-like grammar assisted the 

user in writing programs in much the same manner as he 
thought about the problem. 

The RITA system was designed to prompt the user when a 
rule# goal or object was added. The immediacy of response 
reinforced the user's thinking about the proper method for 
writing RITA programs. The RITA system also prompted the 
user when a syntax error was made. The location of the 
mistake was identified so that the error could be corrected. 

B. incremental knowledge 

Few people know the fundamental concepts# relations# and 
operations that characterize the use of a computer. 
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Consequen t 1 y f teaching must begin at a more basic level 
(Grignetti and others/ 197^). When a program grows in 
power by an evolution of partially understood patches and 
fixes/ the programmer begins to lose track of internal 
details/ loses his ability to predict what will happen/ 
begins to hope instead of know/ and watches the results as 
though the program were an individual whose range of 
behavior were unknown fWeizenbaum/ 1976]. 

The computer-naive user should not be expected to make 
or understand patches to large programs. He has been better 
able to add or delete a production rule that performed a 
particular task. Given the ability to monitor the progress 
of each production rule/ the user has been able to determine 
what his program was doing at all times. 

The production systems as implemented in RITA have 
provided an interesting form of program organization. 
Production rules have tended to represent independent 
components of behavior. The creation and addition of new 
production rules can be incremental/ a feature which has 
facilitated modeling learning processes (Waterman 1970/ 
1975] . 

The computer-naive user has been able to take advantage 
of the incremental feature of the RITA system and write 



comput er 


programs 


that 


per f orm 


a va 


r i e t y 


of tasks 


by 


adding 


a single 


production rule at a 


time. 


The 


user's learning has 


i ncreased 


with 


the 


a d 0 i t ion 


o f 


each 


p roauc t i on 


rule. 


Ho we V e r / 


add i ng 


the 


f i f t h 


rule 


has 


been just 


as 


easy as 
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adainq the first rule. 



C . EXPLANATION SUBSYSTFVS 

One of the designers* goals was to provide a system that 
was able to explain its behavior uoon request. Two 
explanation subsystems were implemented that complement the 
two classes of production systems. 

The first explanation subsystem kept a running account 
of all major activities during the RITA session. The file 
of events kept by the RITA session was valuable in 
determining the behavior of user programs. The intent of 
this subsystem was to provide information for post program 
execution analysis. The user was able to re-create the 
sequence of events for portions or all of the RITA session. 
Any difficulties encountered during the RITA session could 
be duplicated and analyzed. 

The information was available to the user by issuing the 
RITA command **what.'* Also a range of events could be 
specified by using optional parameters with the ”what** 
c omm a no • 

The second explanation subsystem implemented in the RITA 
system served the user during program execution. The 
exolanation subsystem was associated with the action-driven 
production system. This subsystem provided information to 
the user during the deduction of PITA goals. The user^ by 
typing "why”^ caused the RITA system to display the 
requested subqoal that the action-driven production system 
sought to deduce. The user had a means of determining the 
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I 







c^^aining orocess used by the RITA system to satisfy the 
user’s request for the deduction of a RITA goal* 

The implementation of both explantion subsystems was 
simolified because of the choice to use production systems. 
Their facility of allowing incremental information quite 
naturally Provided for discrete activities to be recorded 
eas i 1 y • 
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V. TUTORIAL 



A. OBJECTIVES 

The RITA system was desiqned and implemented as a 
human-oriented interactive computer system. Two support 
documents for the RITA system have been produced [Anderson 
and Gilloglyr 1976; Anderson and others# 1977]. Neither 
document was written to explain the use of RITA to a 
computer-naive person. It was the opinion of this author 
that a carefully constructed document was necessary to 
introduce the c ompu t e r -na i ve person to the RITA system. As 
a result of this thinking# the major thrust of the research 
was to deliver a useable tutorial explaining the RITA 
system. 

The objectives of the tutorial follow: 

1. Introduce the computer-naive user to the features of 
the RITA system as simply as possible. 

2. Write the tutorial assuming the user has no 
programming experience. 

3. Demonstrate the major features of the RITA system by 
simple examples. 

Reauire computer interaction by the user during the 
tutorial . 

5. Identify plainly the sections to be typed by the 
user. 

6. Introduce RITA topics in order of simplicity and 
i moor t ance . 







§ 






Hi 



The first objective was the result of the need for a 



user document at a basic level. The user^ prior to the 
develooment of the accorroanying tutorials was forced to 
piece tooether information from a reference manual in order 
to use the RITA system. The reference manual [Anderson and 
otherSf 1977J was written for a "sophisticated user." 

The tutorial was written for a compu t er-na i ve userr 
therefore^ computer terms were explained in layman’s words. 
The user was not presumec to understand the concents of 
program execution or data base management. 

The use of simple examoles to illustrate the nature of 
RITA commands assured the user that the RITA commands 
worked. Without examples^ the user was not sure how the 
RITA commands functioned. 

The reauirement for the user to actively participate in 
the learning orocess by interacting with the computer 
provided two benefits. The user was forced to get involved 
with the computer^ maintaining a certain attention level/ 
and the typing of RITA commands reinforced the user’s 
understanding of RITA. 

The Portions of the tutorial to be typed at the 
computer terminal by the user were separated from the other 
text. Explicit instructions to the user were capitalized. 

In meeting the last objective/ that of introducing RITA 
topics in order of simplicity and importance/ the user- 
oriented tutorial provided the medium for a we 1 1 -s t r uc t u red 
presentation of information. 
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The tutorial was not desiqned to encompass each feature 



of the 


RITA 


system nor 


was 


it desiqned 


to replace any 


D r e V i 0 u s 


user 


document s . 


The 


tutorial was 


designed to 



present material to the computer-naive user in a simple and 
usef u 1 manner • 

B. PRESENTATION OF INFORMATION 

The information in the tutorial was presented to the 
user in order of simplicity and importance. In each section 
the material to be illustrated was described and definitions 
of technical words were provided. Each specific RITA 
command was demonstrated by a simple example. The user was 
asked to type in the example and observe the computer’s 
response. The example was then thoroughly explained and the 
response of the computer was described when necessary. 

The examples were intentionally kept simple and brief to 
reduce the amount of new information presented to the user. 
Each example was constructed to work correctly. The user 
was not forced to encounter examples that failed to work 
properly. The tutorial assumed adaptive learning by the 
user and/ therefore/ only correct examples were presented. 
Presentation and discussion of ill-behaved examples were not 
included in the tutorial. Convenient stopping points were 
clearly indicated in the tutorial/ relieving the user of the 
responsibility for finishing the tutorial in one session. 

C. VERIFICATION 

The examples presented in the tutorial for the user to 
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type were tested on the PDP-ll/^5 computer at The Rand 
Corporation. The information was accurate at the writing of 
this report. The RITA system has gone through several 
changes and the version of RITA used for the research was 
dated November^ 1977. 

Analysis of user feeoback was minimal. The tutorial was 
used by three individuals. Only one was correctly termed 
'* c ompu t e r -na i V e . ^ The other two users of the tutorial had a 
high degree of computer expertise. In the absence of 
sufficient user feedback, this author was unable to 
anticipate or meet the variety of user needs. Clearly, the 
tutorial has not been examined by a sufficient number of 
users to determine its effectiveness in introducing 
** computer-naive” users to the RITA system. 
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VI . APPLICATIONS 



The RITA system has been designed to be widely 
aoplicable in two general areas. The first area was as a 
front-end to a remote comouting system [Anderson and others^ 
1P77) . Specifically# RITA oroarams would handle 
communication protocols and information transfer for the 
user. The second area was as a support tool for 
administrative and command functions [Anderson and others# 
1977) . 

Several possible applications for the RITA system 
f o 1 low; 

(1) There has existed a need in the U.S. Navy for 
automatic message routing between communication centers. 
The RITA system# implemented in an intelligent terminal# 
would be useful as a tool at each Naval communication 
center. RITA programs could be written to handle message 
sorting and transfer. The communication personnel at the 
communication center would be responsible for typing the 
messages into the RITA system. RITA programs could be 
written to determine addresses# open communication channels# 
send messages# and maintain status of messages sent and 
received. RITA programs could be written to determine 
alternate routes or alternate frequencies for message 
t ransf er . 

(2) The commander at sea has lacked sufficient 
information about the status of the ships in his comm- and. 
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RITA programs could be written to provide status information 
for the commander. The individual ships would update 
information in their data base. The individual ships could 
then execute RITA programs to send the information to the 
at-sea commander or wait for the commander to query the 
individual ships* data bases. RITA programs would handle 
all the information transfer including communication 
protocol . 

(3) Ships at sea have depended on the timely 
communication of information to function effectively. RITA 
programs could be written to operate as a communication 
management system. The cata base of the RITA system on each 
ship could contain all radio frequencies for a given 
geographical area of the world. The user could ask the RITA 
system to deduce the proper frequency for communication 
reception and transmission based on the ship's geograohical 
location. RITA programs could be written to establish 
communication based on the deduction by the RITA system of 
the prooer frequency. At another level/ there could be a 
set of RITA programs that maintained the status of 
communication centers to communicate at certain frequencies. 
The interaction between the RITA system onboard and the RITA 
system at a communication center could provide the ability 
for the RITA system onboard to automatically deduce a 
secondary frequency if necessary. 

(^) Numerous command functions onboard ship have needed 
computer support. The NAVFORSTAT information and battle 
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‘I. 




VIK CONCLUSinNS 



The goals of the research were to describe the nature of 
a specific oroduction system (RITA) and to develop a 
tutorial oocument aimed at explaining the RITA system to a 
compu t e r-na i ve user. The goals of the research have been 
met. However^ an evaluation of the effectiveness of the 
tutorial as a teaching tool was not possible from the 
limited sampling of users. 

The designers of the RITA system have provided a human- 
oriented interactive computer system by using production 
systems for program control and data base management and an 
English-like language for human interaction. The facility 
for creating and adding production rules has provided a 
simple method for incrementally adding user tasks. The 
explanation subsystems in RITA have allowed the user the 
ability to ask the RITA system why particular actions were 
pe r f o rmed . 

The features of the RITA system that have permitted the 
user to communicate with user files and other computer 
systems have been extremely valuable. The power of the RITA 
system has been its nature of intelligent behavior. The 
ability of the RITA system to perform various tasks based on 
the contents of a dynamic data base has been the key to its 
broad appeal. 

As a future research effort/ the automation of the 
tutorial might Drove worthwhile. The program could be 
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lower fork 



to execute RITA while the 



written using a ” 
executive level handlea the tutorial, 
possible without substantial revision to 
tutorial . 



This effort may be 
the contents of the 
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I . PURPOSF OF THF RITA TUTORIAL 



This tutorial will attempt to act as your guide in 
learning and using the RITA system. The tutorial assumes no 
prior knowledge of computer programming techniques and 
therefore has been written with clearness and simplicity as 
key goals. Three documents will he referenced during the 
discussion of how to use the RITA system. The references 
are RITA Reference Manual # >J^^TX for Beginners # and ^ 

T u t o r i a 1 Introduction to the UNIX Text Editor • The 

references will complement this tutorial. None of the 
references will be essential to using this tutorial. 
However# Appendix A of the RITA Reference Man-U-al should be 
useful to show the structure of the RITA language. The 
tutorial is designed to meet the needs of a user who must be 
able to understand# use# and modify simple RITA programs. 

Instructions to the user are in capital letters and are 
separated from other text throughout the tutorial. 

This tutorial does not necessarily reflect the opinions 
or policies of The Rano Corporation or any agencies of the 
Department of Defense. The opinions in this tutorial are 
those of the author alone. 
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I I • OPLANATION OF THE RITA SYSTEM 



RITA is an acronyrr for Ru 1 e -d i rec t ed Interactive 
Transaction Agent. The system was developed by The Rand 
Corooration to attemot to meet several philosophical as well 
as oractical goals. The RITA system was designed as a 
stand-alone computing resource for local text man i pu 1 a t i on ^ 
as a limited heuristic modeling toolf and as a front end to 
remote computing systems and networks. It should be useful 
for maintenance scheduling and control/ command and control 
systems/ intelligence collection and dissemination/ and 
remote accessing of large data bases. 

The RITA system is a set of programs written in the 
programming language that can run under the UNIX operating 
system on minicomputers such as the RDP 11/^5 and POP 11/70. 
RITA makes available a language for writing rules and an 
environment in which those rules are interpreted. The user 
can write a set of IF-THEN rules which can ooerate on local 
information or on information received over communication 
links to external computer systems. 
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MOTIVATION FOR USING THE RITA SYSTEM 



RITA consists of orograms that are very Enqlish-like 
andf therefore/ are easy to read and write. The languaae 
allows the individual to write programs in the manner in 
which he thinks about a oroblem. The language's English- 
like nature assists the programmer in writing programs that 
are easy for a colleague to read and understand. The 
debugging features of the RITA system provide a comfortable 
environment in which the user can locate and correct errors 
in his program. The explanation subsystems in the RITA 
system can explain to the user why a particular action was 
taken. The RITA system has been designed to be used by a 
computer-naive user ano# as such/ it has the capability of 
explaining its actions upon request. 

Sections IV through VII of the tutorial show specific 
procedures to follow to connect a terminal to the computer 
at The Rand Corporation. If you are accessing RITA at 
another host computer the sections mentioned do not apply. 
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IV. CONNECTING THF TERMINAL TO A COMPllTFR BY TFLFPHONF 



This tutorial assumes that the user of the RITA system 
does not have the system available locally and must connect 
his terminal to a remote computer system which has the RITA 
system available. The connection is made using the 

telephone^ via the ARPANET^ to link the user’s terminal and 
the computer system. The example that follows is for a user 
with a Computer Devices ^'initerm terminal. The RITA system 
discussed is available at The Rand Corporation. 
Modification may be necessary for accessing the RITA system 
by another terminal. The RITA system was designed to be 
accessed by a user with a modified Ann Arbor terminal. The 
Ann Arbor terminal was not available to this writer so the 
tutorial is aimed at a user having a crt terminal or 
hardcopy terminal without any special keys. Instructions to 
the user are in capital letters throuohout the tutorial. 

PLUG IN THE POWER CORD OF THE TERMINAL TO A 110 VOLT OUTLET. 

SET THE FOLLOWING POSITIONS ON THE TERMINAL. 

Power : On 
Speed : 30 

Mode : Full (Duplex) 

Mode : Std (Terminal mode) 

Parity : On (Error reset) 

Parity : Even 
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dial the NU'^BER for the tip (TERMINAL INTERFACE MESSAGE 
PROCESSOR) . 



LISTEN FOR A HIGH-PITCHED SOUND. 

PLACE THE TELEPHONE RECEIVER IN THE BACK OF THE TERMINAL. 

(A busy siqnal or ringing for more than six times is an 
unsuccessful attempt at making a connection. Hang up and 
try aga in.) 

type, 

e <c r> 

The <cr> is a symbol for the c a r r i age- r e t u r n key on the 
terminal • 

At the time of this writing the author only had access 
to RITA on the Rand system. If you have access to RITA on 
another system type the address of that host computer. 

TYPE# 

o)o 1 RR <c r > 

The is the symbol to tell the ARPANET that a command 

follows* The '*0** is the command to open a connection to a 

computer. The **199” is the address of the computer at Rand 
Corporation. The <cr> is the symbol for the c a r r i age- r e t u rn 
key on the terminal. 

The response of the computer is **Trying...” followed by 
"Open" on the next line. The following example shows the 



commands the user shoulo tyoe to access the computer at Rand 
Corpora t i on : 

DO not type again, 
e <c r> 

WAIT FOR the terminal TO RESPOND WITH THE NAME OF THE TIP. 

DO NOT TYPE AGAIN, 
a>o 1 R9 <c r > 

WAIT FOR the WORD "Tryino..." TO BE PRINTED AT THE TERMINAL. 



wait for the WORD 



Open" TO BE PRINTED AT THE TERMINAL 
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CORRECTING TYPOGRAPHICAL ERRORS 



After ooenina the connection to the PDP-11 corrputer at 
Rand Corooration the command to erase a mistake is the 
number-sign (^). To erase more than one character type the 
number-sign [ the same number of times as the number of 
characters you wish to erase. After typing the number-sign 
(A) to erase an errors continue tyoinq as if no mistake had 



been made 
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LOG IN PRQCEDIJRFS FOR THF PDP-1 1 



I'MIT FOR THE COMPUTER TO ASK FOR THE USER NAME. 

TYPE ON THE SAME LINE, 
user-name <cr> 

wait for the computer to ask for the password, 

TYPE ON THE SAME LINE, 

Password <c r > 

The user-name and the password are unique for each user, 
(You will need these before you can proceed,) The computer 



response 


upon succ ess f u 1 


login 


is information 


about 


the 


c ompu ter 


system. The 


Compu ter 


responds with 


the 


UNIX 


promDt-sign (%) to indicate it 


' s ready to accent 


UNIX 



commands. (If the computer continues to ask for the user- 
name and password, type the information in until you are 
logged into the computer. The user-name and password must 
be typed in exactly right for the computer to recognize 
y ou , ) 

Let's retrace our path. The terminal was connected to 
the TIP with a telephone call. The TIP (Terminal Interface 
Message Processor) is a processor that connects a terminal 



t 0 


a 


compu t er , 


The 


TIP allows us to 


open a 


connection 


from 


our 


terminal to 


one 


of the compu t e r s 


on the 


ARPANET , 


W e 


chose 


to open 


a 


c onnec tion to the 


PDP-1 1 


computer at 


The 



^3 



P and Corporation where the RITA system resides 



At Rand 



Co rpo r a t 1 on 
computer i s 
is a CO n 
of programs 



the set of programs that manages the PDP-11 
the UNIX operating system. An operating system 
ection of routines for supervising the seouencing 
by a computer. 



VII. (l?>TNr, THF UNIX OPFRATING SYSTEM 



The Drompt~sign (%) for the UNIX ooerating system lets 
the user know that he is in the UNIX system and can issue 
UN IX commands. 

TYPF, 

% date <cr> 

The UNIX command "date" is one of the commands available 
to you as a user of the UNIX operating system. For 
explanations of other commands available on the UNIX system 
use the reference UNIX for Beginners . 
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VIII. ACCESSING THE RITA SYSTFM 



The RITA system is available under the UNIX system at 
Rand Corooration. To use the RITA system do the following: 

TYPE, 

% rita <cr> 

The command ” r i t a ** outs the set of oroqrams known as 
'Vita” into the user's space so that he can write programs 
and issue commands which will be interpreted by the RITA 
system. The RITA system consists of three programs which 
are the UFE (User Front End), PARSER, and MON (Monitor). 



The 


dates indicate 


the 


version of each program. 


that 


i s 


r u n n i n g . 


The 


RITA prompt 


-sign is the asterisk 


(*) , 


^e 


are 


i n 


the 


PITA 


system 


and 


can use all the capabi 


1 i t i es 


o f 


the 



RITA system 
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USING THE RITA SYSTFM 



The RITA system interprets each command as you finish 
typing it. The semi-colon (?) is the terminator for each 
RITA command. It must be typed after each command. The 
RITA system will not respond until the semi-colon (?) 

followed by the carriage-return <cr> has been typed. When 
the RITA command has been typed correctly and the RITA 

system has Performed the commandf it will respond with the 

RITA prompt-sign# an asterisk (*)♦ If the RITA system does 

not understand the command# it will respond with the 

improper command you typed and the words ” syntax error*’. (A 
common error is to misspell a RITA command.) To get the RITA 
prompt-sign (*) after typing in an improper command# ‘type 
the semi-colon (?) followed by the c a r r i age- r e t u r n <cr>. 
Remember# to correct a typographical error# type a number- 
sign ( <^ ) . Occasionally# unexpected terminal pehavior is 
encountered. 

Problem : Program is looping and will not stop. 

Solution : Type the DEL key several times. 

Problem : Command being entered is incorrect. 

Solution : Type the ctrl-esc key followed by a 

carriage-return <cr>. 

Problem : You are unable to aet a RITA prompt-siqn (*). 

Solution : Tyne the ctrl-esc key followed by a 
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carriage-return <cr> 



The typing of the ctrl-esc and the DEL keys several 
times is often necessary. If the orocedures above do not 
solve the problem then press the a) key followed by the c 
key. The 3c command followed by the c a r r i age- r e t u rn <cr> 
closes the connection to the computer on the ARPANET. Then 
you can open the connection to the computer again by 
following the procedures in the section of the tutorial 
titled CONNECTING THE TERMINAL TO A COMPUTER BY TELEPHONE. 
The first command would be to ooen a connection by typing a)o 
199 for the computer at Rand Corporation. If that failsf 



hang up the phone 



X . ENTERING A RITA OBJECT 



Units of information in your RITA program are stored as 
objects. Each object has a name and an arbitrary number of 
attributes. The object-name must be an unquoted string of 
characters not starting with a digit and not containing 
blanks or any of the following: (] () <> {} & ? : , ; * 

Each attribute must be an unquoted string of characters with 
the same restrictions as the object-name. Each attribute 
has a value. A value may be a quoted string of characters^ 
a RITA number# an ordered list of values# or unknown. A 
quoted string of characters is an arbitrary arrangement of 
symbols# letters# and numbers enclosed in quotation marks. 
An unquoted string- is not enclosed in quotation marks. The 
quoted string may contain blanks as well as any other 
characters on the terminal keyboard. The discussion of a 
value as a list of values will be postooned until later in 
the tutorial. The followina examples will show some of the 
character strings alloweo for object-names# attributes and 
values. 



OBJECT-NAME ATTRIBUTE 



ship 
pi ane 1 

dest royer-name 
meal .time 



speed 
payload 
naval -hero 
dinner *menu 



VALUE 

20 

“Two bombs” 

“John Paul Jones” 
NOT KNOV^N 
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The following are not allowed: 



GBJECT-NAN'E ATTRIBUTE VALUE 

30ships snruance class fast&capable 

"olane** soeec? excessofbOOknots 

Captain's name 3rd [Jones] 

The object-nameS/ attributes and values in the example 
above were unsatisfactory for the following reasons. An 
object-name cannot begin with a digit C3)f contain a special 
character ( ” ) or contain a soace. An attribute cannot 
contain a soace^ contain a special character (?) or begin 
with a digit (3). A value cannot be an unquoted string of 
characters. Let's enter an objects give the object an 
attribute# and assign a value to the attribute. Objects can 
be entered in two ways. 

TYPE# 

* object shio <cr> 

name is "John F. Kennedy"# <cr> 

The object-name is "ship". The attribute of the object 
is "name". The value of the attribute is "John F. Kennedy". 
The semi-colon (;) terminates the RITA command and the RITA 
system can begin to process that command. The second method 
of entering objects is tc use the create command. 

type# 

* create a olane whose name is "F-1^ Tomcat"# <cr> 
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The object-name is “plane**. The attribute is **name**. 
The value is “F-IU Tomcat**. A semi-colon (;) terminates the 
RITA command. This form provides for improved readability 
because the articles A, AN, and THE can be inserted anywhere 
without affecting the RITA command **create**. Let's look at 
the two objects that have been entered in the RITA system. 
There are three methods for printing objects. 

TYPE, 

* disolay object ship; <cr> 

wait for printing AT THE TERMINAL TO STOP. 

TYPE, 

* display object olane; <cr> 

*’ Display** is the RITA command to print information. The 
word ** object** tells the RITA system that we want to look at 
an object. **Ship*’ is the object-name in the first RITA 
command and “olane** is the object-name in the second RITA 
command. The semi-colon (;) terminates input of the RITA 
c ommand . 

type, 

* disolay object shio and display object plane; <cr> 

Rita commands can be combined by an **and**. They may 

extend for more than one line. The semi-colon (;) lets the 
RITA system know when it should perform the RITA commands. 

type. 
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* display all objects; <cr> 

"All" is a word in the RITA systein that is used to 
indicate that the commanc applies to every object. 
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XI , ENTFRIMG A RITA RUt F 



Most RITA programs are comprised of objects and rule- 
sets. A rule set is a collection of IF-ThEN statements 
(rules). Each rule has a name^ a set of premises^ and a set 
of actions. The IF part of a rule consists of a set of 
premises. All the premises must be true for the rule to be 
true. The THEN part of a rule consists of a set of actions. 
The actions are performed seauentially when the IF part is 
true. The name of a rule can be an unquoted string of 
characters not starting with a digit and not containing 
blanks or any of the following: The name 

of a rule can also be a cuoted string of characters. There 
are two methods for entering rules. 

TYPE. 

* rule carrier <cr> 

if the name of the ship is ”John F, Kennedy*' <cr> 
then set the caotain of the ship to "Aviator"; <cr> 

* rule fighter <c r > 

if the name of the plane is "F-1^ Tomcat" <cr> 
then set the pilot of the plane to *’Ace" <cr> 
and RETURN SUCCESS; <cr> 

The first RITA rule has the name "carrier". "If" is a 
reserved word to indicate the beginning of the IF part of 
the rule. A reserved word is a word used by the computer 
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system that has a special meaning and must be used by the 
user in the same context. "Name” is the attribute of object 
"ship”. The value of the attribute is "John P. Kennedy”. 
"Then” is the reserved word to indicate the beginning of the 
THEN part of a rule. "Set” is an action word that adds or 
modifies information about objects. ’’Captain” is an 
attribute of object "ship". The value of the attribute is 
"Aviator”. The semi-colon (;) terminates the RITA command. 
Rule "fighter” is in the same format as rule "carrier”. The 
words "RETURN SUCCESS” in rule fighter have special meaning 
to the RITA system. The reason for including them will be 
explained later in the tutorial. There is no restriction on 
the number of premises or actions in a rule. Each rule 
should be lengthy enough to perform a function. However/ 
shorter rules are usually less complicated and easier to 
read. The second method of entering rules is to create an 
i mmed i a t e rule. 

DO not TYPE/ 

* if there is a ship whose name is "John F. Kennedy" <cr> 

then set the captain of the ship to "Aviator"; <cr> 

The immediate rule cannot be saved in an external file 
for a later RITA session. The immediate rule tests the 
premises only once and executes the actions if all the 
premises are true. The immediate rule should be used when 
the user desires to test the rule only once and does not 
wish to save the rule for later use. The first method of 
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enterinq rules is preferred under most circumstances. Let’s 
print the rules in our program. (If the RITA system at any 
time stops printing at the terminal and responds with the 
word "pausing”/ press the carriage-return <cr> key to cause 
the printing to continue. The command "pausing” should be 
expected occasionally.) 

TYPE/ 

* display all rules? <cr> 

TYPE/ 

* display rule carrier and display rule fighter? <cr> 

The display command is used to print rules just as it 
was used to print objects. Let’s print all the objects and 
all the rules. 

TYPE/ 

* display all objects and display all rules? <cr> 

Objects ship and plane and rules carrier and fighter 
comprise our entire program. 
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XII. displaying RITA OBJECTS AND RTTA RULFS TO EXTERNAL FTLFS 



To save our oroaram/ we put it into an external file. A 
file is a place to store a collection of information where 
the order is maintained. External is a term for something 
outside the RITA system. The external file is outside the 
RITA system and is a file in the UNIX system. In the 
examples that follow^ replace the author’s initials ”tew” 
with your own, 

TYPE. 

* display all objects to file navy-blue, tew; <cr> 

* display all rules to file navy-blue.tew; <cr> 

The first Rita command puts all the objects into a file 
which has a filename of ’’navy-blue. tew”. The second RITA 
command puts all the rules into the same file which has a 
filename of ” navy-blue. tew”. The UNIX file ” navy-blue. tew” 
contains object ship, object plane, rule carrier and rule 
fighter. The information is in file ”navy -blue. tew” in the 
order that we entered the objects and entered the rules. 
Notice that the filename ”navy-b 1 ue . t ew” contains no blank 
spaces and is one continuous name. File ’’navy-blue. tew is 
a permanent record of our program. Leaving the RITA session 
or creaking the telephone connection will not destroy our 
file ”na vy-b 1 ue . t ew” . Our program exists in the RITA system 
as well. The display command just made a copy of the 
objects and rules in t-he external file ’’ na vy -D 1 ue . t e w ” . No 
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information 



was altered 



in our d r og r am 



in the RITA system. 
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XIII. CREATING A UNIX SHELL PROGRAM 



A "shell** is a UNIX croqram that reads and interorets 
UNIX commands. The reason for creatina a shell in UNIX is to 
allow the use of facilities outside the RITA system. We can 
create a shell/ temoorarily leave the RITA system/ perform 
tasks in the UNIX system/ then return to the RITA system. 

TYPE/ 

* shell; <c r> 

The RITA command *’ shell'* causes a shell program in the 
UfJIX system to be created. We temporarily leave the RITA 
system and can issue UNIX commands. The UNIX promot-sign 
(%) indicates that we are in the UNIX system. 
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XIV 



VTEl^ING AN EXTERNAL FILE 



Our external file "navy-blue. tew" is available in the 
UNIX system. Occasionally* we desire to make changes to the 
file or to print the information in the file. The reference 
A Tutorial Introduction to the UNIX Text Editor discusses in 
length how to make changes to UNIX files. (Note; UNIX 
commands do not end with the semi-colon (;). RITA commands 
do end with the semi-colon (;).) 

TYPE* 

X Is <cr> 





The 


UNIX 


command 


"Is" 


is the command 


to list 


the names 


0 f 


al 1 


our 


f i 1 e s • 


The 


Unix command *’ls 


'* is useful when 


we 


have 


severa 1 


files and can*t remember the 


exact 


spe 1 1 i nq 


o f 


the 


f i 


1 e we 


wish 


t o 


review* Other 


UNIX 


commands 


are 



discussed in the reference UNIX f.p.r Beginners. 
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XV 



EDITING A UNIX FILF 



After typing the UNIX con^mand the UNIX system 

responds with the name of our only file# ”navy-blue.tew"« 
Let’s make several changes to our file. Replace the 
initials *'tew” with your own. 

TYPE# 

% ed navy-b 1 ue • t ew <cr> 

The UNIX command "ec” makes the standard UNIX text 
editor available to the user. An editor is a program that 
can make additions# deletions# and changes to a UNIX file 
and print portions of that UNIX file at the terminal. 
Actually# our UNIX file "navy-b 1 ue • t ew” has been put into 
the working space of the UNIX editor. The UNIX system 
responds with the number of characters in our file (3^^). 
Let’s print all the lines in our file. 

TYPE# 

1 # Sp <c r > 

The "I" tells the editor to start at line one (1). The 
tells the editor to stop at the last line in the file. 
The comma (#) separates the first line from the last line. 
The "o" is an editor command to print. The "l#$p" command 
causes the editor to print lines one (1) through the end of 
our file at the terminal. 
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I^AIT for printing at the terminal to stop. 

TYPE. 

<c r> 

The editor command causes line four (4) of our file 

to be printed at the terminal. 

TYPE. 

^s/shio/boat/p <cr> 

The editor command ”s** causes the substitution for the 
old characters "ship** by the new characters "boat". The 
slant lines (/) are separators. The **p" is an editor 
command to print the line at the terminal. The characters 
'•ship'* have been changed to "boat"* 

TYPE. 

- w <c r > 

The editor command "w" stands for write and is the 
command to make the change Permanently to our file. Until 
the "w" (write) command is used. the changes are only 
temporary and will be lost if the user leaves the editor. 

TYPE. 

4d <c r > 

TYPE. 

4s/boat/ship/p <cr> 

The editor command "4d" prints line four (4) of our 
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The **s” (substitute) command causes the old 
characters **boat** to be reolaced by the new characters 
"ship**. The slant lines (/) are separators# The is an 
editor command to print the line at our terminal. Let’s 
make the chanqe permanent to our file. 

TYPE, 
w <c r > 

Our file '* na v y *b 1 ue . t e w ” has been modified by changing 
the characters ’’ship” in line four (^) to ’’boat”. The file 
has been returned to its original condition by changing the 
characters ’’boat” back to ”shio”. Leaving the RITA system 
by creating a U^iIX shell program, then calling and using the 
UNIX text editor consumes a great amount of time. Changes 
that are not extensive can best be performed in the RITA 
system itself. A RITA command ’’delete” will be introduced 
that allows objects and rules to be eliminated. The 
eliminated object or rule could then be typed into the RITA 
system again with the changes. 

TYPE, 

q <c r> 

The editor command ”o” is for quit. The ”a” (quit) 
command causes the user to leave the UNIX editor and return 
to the UNIX shell program. Notice the UNIX prompt-sign (%). 



62 



XVI . &ETURMNG^TQ__THE RITA SYSTEM 



(Remember the Ctrl key is one key and not four 
ones. ) 

TYPE/ 

% c t r 1 -d 

(Press the d key while simultaneously holding 
Ctrl key.) The UNIX command **ctrl-d” causes us to 
UNIX shell program and return to the RITA system 
the RITA prompt-sign (*), 



separate 



down the 
leave the 
Not ice 
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XVII. DELETING OBJECTS AND RUL^S TM THF PITA SYSTEM 



Until a RITA session is terminatedf all the objects and 
rules entered in the RITA system are still present. RITA 
objects and RITA rules can be erased from our RITA proaram 
by using the RITA command "delete". 

TYPE, 

* display all objects and display all rules; <cr> 

The RITA command "display" causes the objects and rules 
in our RITA orogram to be printed at the terminal. 

TYPE, 

* delete object ship; <cr> 

* delete rule carrier; <cr> 

The RITA command "delete" erases the RITA object or RITA 
rule specified from our RITA program. 

TYPE, 

* display all objects and display all rules,’ <cr> 

Object "ship" and rule "carrier" are no longer part of 
our RITA orogram. 

TYPE, 

* delete all objects and delete all rules; <cr> 

The RITA command "delete" used with the word "all" 
permits us to erase all the objects and all the rules in our 
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» 



i 






RITA D roq ram 



TYPEr 

* display all objects and display all rules; <cr> 

There are no objects or rules that remain as a part of 
our RITA program, Usinq the **delete” command is an 
effective way to eliminate incorrect or unwanted RITA 
objects or RITA rules. However^ the RITA command ** delete'* 
should be used cautiously. 



IF 


YOU 


WISH TO TERMINATE 


THE RITA SESSION AT 


THIS TIME 


TURN 


TO 


THE 


SECTION OF THE 


TUTORIAL titled 


LEAVING A 


RITA 



SESSION, 
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XVIII. LOADING AN EXTERNAL FILE 



All the objects and rules have been deleted from our 
RITA program. Howeverf the objects and rules are in the 
UNIX file ”navy-b 1 ue . t ew” and can be put into the RITA 
system without our retyping them* Supply your initials 
instead of the author’s initials^ i-e*# tew* 

TYPE, 

* load na vy-b 1 ue . t ew ? <cr> 

The RITA command ’^load'* causes the information contained 
in file ”navy-blue*tew" to be placed into the RITA system. 
The file is checked to ensure that the objects and rules are 
correctly written. The semi-colon (;) terminates the RITA 
command. The RITA system responds that the objects and 
rules were correct and have been added to the RITA system* 

TYPE, 

* display all objects and display all rules; <cr> 

There is an alternate method for loading an external 
file. The *’fload'* command can be used in exactly the same 
manner as the **load” command* The difference is that the 
file is not checked for correctness when the "fload” command 
is used* The safest command to use is the "load” command. 

DO NOT TYPE, 

* fload na vy-b 1 ue * t ew ; <cr> 
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The RITA system responds to the 



fload*' command exactly 



as it responds to the "load” command. However# 
information about the objects or rules is provided. 



no 
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XIX . PEeUGGI.Mf, INFORMAT TDN 



Debugging is the process of finding and correcting 
errors in programs. Several very useful debugging commands 
are available in RITA to assist the user in finding and 
correcting program errors. The first debugging command we 
will use is the "trace** command. 

TYPE/ 

^ trace all rules; <cr> 

The RITA system resoonds with the RITA prompt-sign 
to let us know that our command has been understood. 
Throughout the remainder of the tutorial the system response 
to a RITA command will usually be the RITA prompt-sign (*). 
^Nhen the system response differs it will be so indicated. 
i‘^e*ve asKed the RITA system to trace all the objects and 
rules in our oroqram. Let's display them to refresh our 
memory as to what they were. 

TYPE/ 

* display all rules; <cr> 

An alternative method of tracing the rules in our RITA 
program f o 1 lows: 

TYPE/ 

* trace rule carrier ana trace rule fighter; <cr> 

The RITA command *’trace** can also be used to trace a 
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single objectf attribute or rule. Thus^ the RITA command 
"trace** is a command that allows the user to observe the 
operation of his RITA orogram. 

TYPE, 

* set traced; <cr> 

run; <cr> 

More detail about the RITA program is available by using 
the **set trace" command. The RITA command "set trace" 
allows the user to obtain more debugging information if 
desired. The levels of information available range from a 
low of zero (0) to a high of four (^). The normal mode is 
level zero (0). The RITA command "run** causes the RITA 
system to test each rule and to perform the actions for each 
rule found to be true. 

TYPE, 

^ set trace 0; 

* trace all rules; 

wait for PRINTING AT 
TYPE, 

* run; <cr> 

The RITA command "set trace 0" asks the RITA system to 
provide the least debugging information available. The RITA 
command "trace** asks the RITA system to print information 
about the rules when their actions are performed. The RITA 



<c r > 

<c r> 

THE TERMINAL TO STOP. 
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command ’’run'’ is a command to start looking at the If part 
of each rule and determine if the premises are true. The 
’’run” command also causes the Then part of each rule i t h a 
set of true premises to be performed* The rules are 
executed seouentially until all rules are determined to be 
false or the RITA action word ’’return” is encountered as 
part of the Then Dart of a true rule* (NoteJ The RITA 

system will continue to cycle through the rules forever if 
the action word ”return” is not encountered in a true rule* 
The word ”RETURN” was included in rule fighter to prevent 
the system from cycling through the rules indefinitely. The 
word ’’SUCCESS” was used to have something printed at the 
terminal* If all the rules are false on any one pass the 
system will also stop*) 

The debugging information available about our RITA 
program is quite substantial* The RITA command ’’set trace 
is more useful than the RITA command ’’set trace 0” for the 
user when he is trying to locate and correct program errors* 
The RITA command "set trace” determines the level of 
debugging information provided by the RITA system* The RITA 
command ’’trace" is the command that causes the RITA system 
to print the debugging information* Both RITA commands ’’set 
trace” and ’’trace" are used prior to issuing the RITA 
command ’’run”. The RITA command ’’untrace" causes the RITA 
system to provide no announcement when the RITA rules are 
performed. The RITA command ’’untrace” has the opposite 
funcion of the RITA command ’’trace”. 
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TYPE 



* untrace all rules; <cr> 

WAIT FOP PRINTING AT THE TERMINAL TO STOP. 

TYPE/ 

* run; <cr> 

The debugging facilities in the RITA system allow the 
user to observe the ooeration of his RITA program by using 
the RITA commands "trace" and "untrace". The debugging 
facilities in the RITA system allow the user to also 
intervene in the operation of his RITA program by using the 
RITA commands "stop" and "unstoo". 

TYPE/ 

*settrace^i; <cr> 

* trace all rules; <cr> 

WAIT FOR PRINTING AT THE TERMINAL TO STOP. 

TYPE/ 

* stop at all rules; <cr> 

wait for printing at the terminal to STOP. 

TYPE/ 

* run; <cr> 

The RITA command "set trace ^1 " sets the level of 
debugging information high. The RITA command "trace all 
rules" causes the RITA system to announce each rule that is 
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found true when the actions are performed. The RITA command 
'*stoP at all rules'^ causes the RITA system to suspend 
execution of the **run” command before the actions of each 
true rule are performed. The RITA command **run" causes each 
rule to be tested and the actions of the rules found to be 
true are performed. 

TYPE/ 

* con t i nue ? <c r> 

^ run ; <c r > 

The RITA command "continue*’ is used with the RITA 
command "stop** to cause the RITA system to resume performing 
the actions of the current rule. In place of issuing the 
** Continue" command the user could type any other RITA 
command. The RITA command "unstop" reverses the process 
that the RITA command **stop" caused. 

TYPE/ 

* unstop all rules; <cr> 

*run; <cr> 

The RITA command **unstoo" causes the RITA system to 
allow no intervention in the operation of the user's RITA 

program . 

TYPE/ 

* set trace 0; <cr> 

* untrace all rules? <cr> 
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The RITA system debugging commands have been reset to 
their normal modes. The following are examples of other 
uses of the debugging commands: 



DO 


NOT TYPE, 






* 


trace 


rule 


c a r r i e r ; 


<c r> 


* 


trace 


object ship; 


<C r > 


* 


trace 


boa 1 


victory. 


<c r> 


it 


trace 


al 1 


rules; 


<c r > 


it 


t race 


al 1 


objects; 


<C r > 


It 


t r ac e 


al 1 


goals; 


<c r > 


* 


trace 


al 1 


rules that 


set name of ship; <cr> 


* 


t race 


al 1 


rules that 


test name of plane; <cr> 


* 


t r ac e 


al 1 


goals that 


set name of ship; <cr> 


* 


trace 


al 1 


goals that 


test name of olane; <cr> 


* 


trace 


name 


of plane; 


<c r > 



The RITA command "trace rule carrier" is used when a 
single rule with a specific rule-name (i.e. carrier) is to 
be traced. 

"Trace object ship" is used to trace a single object 
with a specific object-name (i.e. ship). 

"Trace goal victory" is used to trace a single goal with 
a specific goal-name (i.e. victory). Goals will be 
discussed later in the tutorial. 

"Trace all rules" is used to trace each rule in the RITA 
program. "Trace all objects" and "trace all goals" are RITA 
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commands used to trace each object and trace each goal 
respect i ve 1 y . 

** Trace all rules that set name of ship” is used to trace 
all rules that cause the attribute (i,e. name) of the object 
(i.e. ship) to be enterea or changed in our RITA program, 
"Trace all rules that test name of plane" is used to trace 
all rules that check the attribute (i.e. name) of the object 
(i.e. plane) in our RITA program. 

"Trace all goals that set name of ship" is used to trace 
all goals that cause the attribute (i.e. name) of the object 
(i.e. ship) to be entered or changed in our RITA program. 
"Trace all goals that test name of plane" is used to trace 
all goals that check the attribute (i.e. name) of the object 
(i.e. plane) in our RITA program. 

"Trace name of plane" is used to announce the specified 
object (i.e. plane) when its attribute (i.e. name) is 
c hanged . 

All the debugging commands are used with the "run" 
command. They proviae facilities for observing and 
intervening in the operation of a RITA program. Therefore# 
the RITA commands "trace#" "untrace#" "stop at#" "unstop" 
and "set trace" are valuable tools for locating and 
correcting program errors. 

type# 

* delete all objects ana delete all rules; <cr> 
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IF YOU WISH TO TERMINATE THE RITA SESSION AT THIS TIME 



TURN 



TO THE SECTION OF THE TUTORIAL TITLED LEAVING 

session. 



A RITA 



75 



^ • explanation of the LH S (L E FT H AN D SIDE) MONITORS 



The RITA system consists of a set of three proqrams. 
One of the three proorams is the monitor. A monitor is a 
computer program that evaluates a set of rules by testing 
the premises (If part) and performing the cor respond i ng 
actions (Then oart) for all rules that are true. There are 
two left-hand-side monitors# the ordered and the cyclic# in 
the RITA system. i^hen either the ordered or the cyclic 
monitor is used# it will test rule premises and perform the 
actions of all true rules. 

The cyclic# or unordered# monitor begins testing rules 
at the top of the rule-set list. When one rule is found to 
be true# the actions of that rule are performed. The cyclic 
monitor tests the next rule in the list. After checking the 
last rule in the rule-set list# the cyclic monitor begins 
again at the top of the rule-set. The orocess continues 
until all rules are founc to be false in one pass or the 
RITA word "return” is encountered in the action part of a 
true rule. 

The ordered monitor behaves exactly the same as the 
cvclic monitor except the next rule tested after findino a 
true rule is the first one in the rule-set list. Ordered in 
this sense means that when one rule is found to be true/ the 
monitor should start again at the beainning of the rule-set. 

Let’s build two small proarams to illustrate the 
differences between the cyclic and ordered monitors. (If 



76 



you type in a rule or object incorrectly and the system 
responds "syntax error", type the semi-colon (;) and type a 
carriage-return <cr>. The RITA orompt-siqn (*) should 
aooear. Now tyoe in the RITA command correctly.) 



TYPE, 




* object ship 


<c r> 


name is "JFK"; 


<c r> 


* object plane 


<c r> 


name is "A-7"; 


<c r > 


* object squadron 


<c r > 


name is "fighter"; 


<c r > 


* rule cyclic! 


<c r > 



If the name of the ship is "JFK" <cr> 

Then set the name of the ship to "JFK"; <cr> 

* ru 1 e eye 1 i c2 <c r> 

If the name of the plane is "F-IA" <cr> 



Then RETURN SUCCESS; 


<c r> 


* rule cyclicS 


<c r > 



If the name of the sauadron is "fiahter" <cr> 



Then set the name of 


the plane to <cr> 


TYPE, 





* display all objects and display all rules; <cr> 

type, 

* display all objects to file cyclic. tew; <cr> 

* display all rules to file cyclic. tew; <cr> 
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All the oh) j ec t s and rules in our RITA propram have been 
out into an external UNIX file named ** cyclic. tew**. The 
cyclic or unordered monitor is called by using the RITA 
commands **set unordered** and **run*‘, 

TYPE, 

^ set t race ^ ; <c r> 

* trace all rules; <cr> 

I^AIT for PRIN'TING at the terminal to stop, 
type, 

* set unordered; <cr> 

* r un ; <c r > 

The RITA command **set trace ^** sets the level of 
debugging information to be orovided to the user. **Trace 
all rules** causes the'RITA system to announce each rule as 
it*s tested. **Set unordered” causes the cyclic monitor to 
be used. **Run” causes the RITA system to test RITA rules 
and to execute the actions of the rules found to be true. 

Let*s follow the RITA orogram as the cyclic monitor 
tests and executes RITA rules. The If oart of rule 
**cyclicl” is true because when we created the object shio, 
the value of the attribute (i.e. name) was set to **JFK**. 
Rule ** cyclic?** is false. The name of the plane is **A-7**, 
not **F-1^**. ’/ihen we created the object plane, we made the 
attribute name have a value **A-7**. Rule **cyclic3** is true 
so the name of the plane is changed to **F-H1**. 
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The cvcHc monitor starts aoain at the too of the rule- 
set. Rule ”cyclicl'* is true. Rule **cyclic2” is true 
because rule ”cyclic3” set the name of the plane to **F-14** 
previously. The cyclic monitor stops because it encounters 
the RITA word ” return'* in a true rule "cyclic^^’*. 

TYPE, 

* set t race 0 ; <c r> 

* untrace all rules; <cr> 

* delete all objects ana delete all rules; <cr> 

* display all objects and display all rules; <cr> 

The second program will be used to show how the ordered 
monitor works. Remember, the ordered monitor tests the 
rule-set sequentially from the top until the first true rule 
is found. Its actions are performed and the ordered monitor 



ret urns 


to the 


t OP 


of the 


r u 1 e-set 


to continue testing. 


The 


o rde r ed 


mon i t o r 


stops 


when the 


RITA 


word "return" 


i s 


encountered as 


an 


action 


in a true 


rule 


or when a 1 1 


the 



rules are false on one pass. 
TYPE, 



* object 


ship 


<c r> 


name i s 


"JFK" ; 


<c r> 

1 


* object 


plane 


<c r > 


name i s 


"A-7" ; 


<c r> 


* object 


sauadron 


<c r > 


name is 


"fighter"; 


<c r > 



* rule orderedl <cr> 
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If the name of the ship is "JFK" <cr> 

Then set the name of the ship to "America"; <cr> 



* rule ordered? <cr> 

If the name of the plane is <cr> 

Then set the name of the plane to "F-ia"; <cr> 

* rule ordered3 <cr> 

If the name of the squadron is "fighter" <cr> 

Then RETURN SUCCESS; <cr> 

type, 

* display all objects and display all rules; <cr> 



Notice that the program to demonstrate the cvclic 
monitor is different than the program above. Let's save our 
program by putting it into an external UNIX file named 
"ordered. tew" . 



<c r> 
<c r > 



TYPE, 

* set trace 

* trace all rules; 

wait for PRINTING AT 
TYPE, 

* set ordered; <cr> 

* run; <cr> 



<c r> 

<c r > 

THE TERMINAL TO STOP. 



TYPE, 

* display all objects to file ordered. tew; 

* display all rules to file ordered. tew; 
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The ordered monitor is called by using the '*set ordered” 
and ”run” commands* The ordered monitor tests rule 
”orderedl”. The rule is true because the name of the ship 
is ”JFK”. The action of rule "orderedl” is to set the name 
of the shio to ^America”* The ordered monitor has found a 
true rule# performed its actions and returned to the top of 
the rule-set* Rule "ordered!” is tested again. This time 
it is false because the name of the shio is now "America"# 



not "JFK" 


• Rule " 0 r de r ec2 " 


is tested and 


1 s 


found to 


be 


f a 1 se . 


The name of the 


Plane is "A-7", 


not 


" F - 1 a . 


Rule 


"orderedS 


" is tested and since the name of 


the 


SQuad ron 


i s 



"fighter"# the action of the rule "ordered3" is oerformed. 
Because the RITA word "return" is part of the actions for 
rule ”ordered3"# the ordered monitor stops. 

The LHS (Left Hand Scan) monitors# cyclic and ordered# 

are useful for situations where the information stored in 

the objects can change* The LHS (Left Hand Side) monitors 

are also referred to as pa t t e r n -ma t c h i ng or r u 1 e-d i r ec t ed 
monitors* The behavior of the monitors depends on matching 
a oattern (If part) and performing actions based on which 
rules are found to be true* 

TYPE# 

* set trace 0; <cr> 

* untrace all rules; <cr> 

* set unordered; <cr> 

* delete all objects ana delete all rules; <cr> 
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IF YOU -MISH TO TERMINATE THE RITA SESSION AT THIS TIME 



TURN 



TO THE SECTION OF THE TUTORIAL TITLED LEAVING 

session. 



A RITA 
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XXI. RUNNING A RITA PROnPAM 



Running, or executing, a program means the process of 
carrying out the steps specified to produce the reguired 
results. We've run several programs already in our 
discussion of other RITA commands. The RITA command "run" 
has two forms. 

TYPE, 

^ load na vy-b 1 ue . t ew ; <cr> 

wait fop printing at the terminal to stop. 

TYPE, 

* display all objects and display all rules; <cr> 

We*ve loaded our file ” navy-blue. tew” in order to have a 
proqram to run . 

TYPE, 

* run rule carrier; <cr> 

The first form of the ”run” command is ”run rule rule- 
name”. The rule we wish to execute is rule ” carrier”. That 
one rule has been interpreted and executed. No other rules 
were affected by the ”run rule rule-name” command. The 
second form of the ”run” command causes all rules in the 
program to be interpreted and executed. If the particular 
LHS monitor is not indicated# the default monitor is the 
cyclic, or unordered, monitor. 
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TYPE 



♦ run ; <c r > 

All rules in our RITA program have been interpreted and 
executed. Execution stops when all the rules in the rule-set 
are found to be false on one oass or the RITA word return** 
is encountered in the actions of a true rule, 

TYPE, 

* delete all objects ana delete all rules; <cr> 

IF YOU WISH TO TERMINATE THE RITA SESSION AT THIS TIME TURN 
TO THE SECTION OF THE TUTORIAL TITLED LEAVING A RITA 
SESSION, 
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XXII 



ENTERING AND DISPLAYING A RITA GOAL 



RITA programs can contain goals as well as objects and 
rules. A RITA goal is a RITA rule that is used with the RHS 
( R i qh t -Hand-S i de ) monitor only. THe RHS ( R i gh t -Hand-S i de ) / 
or goa 1 -d 1 r ec t ed / monitor differs from the LHS (Left-Hand* 
Side) monitors in that the qoa 1 -d i r ec t ed monitor checks the 
action oart (Then part) of each RITA goal to determine the 
goals which will be useful in determining the information 
desired by the user. When the actions of a goal are 
determined to be useful/ the premises (If part) of the goal 
are tested to see if all the premises are true. If so/ the 
actions of the true goal are executed. Perhaps an example 
will show the nature of a RITA goal. 

TYPE/ 

* goal performance <cr> 

If the productivity of the ship is "excellent” <cr> 

Then set the performance of the ship to ” outstanding ";<cr> 
*goalcaptain <cr> 

If the status of the ship is "underway" <cr> 

Then set the captain of the ship to "happy"; <cr> 

*goal productivity <cr> 

If themoraleof the ship is "high" <cr> 

Then set the productivity of the ship to <cr> 
"excellent"; <cr> 

* goa 1 mo r a 1 e <c r> 
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If the caotain of the shin is "happy** <cr> 

Then set the morale of the ship to **high**; <cr> 

RITA goals are entered into the RITA system in the same 
form as RITA rules. However^ goals differ in that the 
(Riaht-Hand-Side) monitor tests RITA goals until it finds 
the user-requested information/ or until it determines that 
tne information requestec is not currently available. The 
RITA system in the latter case prompts the user to supply 
preliminary information needed for the aoal-directed monitor 
to continue its search for the requested information. The 
gOal*directed monitor is most useful in a static situation/ 
where the information once determined will keep the same 
values. 

TYPE/ 

* display all goals to file monitor. tew; <cr> 

* display all goals; <cr> 

The ** display all goals to file monitor.tew" command 
makes a copy of the goals in our RITA program and puts it 
into an external UNIX file named '* monitor. tew**. The command 
"display all goals" causes the RITA system to print the RITA 
goals at the terminal. The four goals make up our entire 
Rita program. 
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XXIII. DEDIiCTNfi a RITA QRAI 



The goal-oriented monitor is called by using the HITA 
command deduce . We must tell the RITA system what we want 
to be determined* 

TYPE. 

* create a sHip whose status is "underway*'; <cr> 

* disolay object ship; <cr> 

wait for printing at the terminal to stop. 

TYPE. 

* deduce the Performance of the ship; <cr> 

wait for printing at the terminal to stop. 

TYPE. 

* display object ship; <cr> 

The "create" form of entering an object was used to 
enter an object (i.e. ship) with an attribute (i.e. status) 
whose value is "underway". Goal "captain". when tested, 
will be true and the process of finding the performance of 
the ship can begin. 

The RITA command "decuce the performance of the ship" 
causes the RITA system to start the goa 1 -o r i en t ed monitor. 
The information reauestec is in the form attribute (i.e. 
performance) of the object (i.e. ship). The monitor will 
determine the value of the attribute (i.e. performance) of 
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t^e object (i.e. shio). Rememberf the qoa 1 -o r i en t eo monitor 
does not test the goals sequentially. The action oart (Then 
part) of each goal is checked to see if it applies. If so^ 
the oremises of the goal are tested. If the oremises are 
all found to be true# then the actions of that goal are 
pe r f o rmed . 

In our Program the goal-oriented monitor checks the 
action parts of the goals until one applies. Goal 
** Performance**^ if true# would provide the information 
requested. (What is the value of the performance of the 
shio?) However/ the ooal ''performance** is false. The value 
of the "productivity of the shio" is unknown. The goal- 
oriented monitor then scans the actions parts of each goal 
until it can find a value for the "productivity of the 
shio". Goal "productivity"/ if true/ would provide a value 
for the "productivity of the ship". Goal "productivity" is 
false. The value of the "morale of the ship" is unknown. 
The monitor scans the action parts until it finds a value 
for the "morale of the ship". Goal "morale"/ if true/ would 
provide a value for the "morale of the ship". Goal "morale" 
is false. The value of the "caotain of the ship" is 
unknown. The monitor checks until it finds a value for the 
"captain of the ship". Goal "captain" is tested and is 
found to be true. The status of the ship is "underway". 
Remember/ we created an object (i.e. shio) with an attribute 
(i.e. status) whose value was "underway". 

The goal-oriented monitor performs the actions of goal 
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Captain , The captain of the ship is set to haopy. Goal 
iTiorale is now true. The morale of the ship is set to 

high. Goal "oroductivity” is now true. The productivity of 
the ship is set to excellent. Goal "performance” is now 

true. The performance of the ship is set to outstanding. 
Now/ our original question can be answered. iNhat is the 

performance of the ship? The value of the performance of 
the ship is "outstanding”. 

If the value of the specified attribute of a particular 
object is already known/ the deduction terminates. If no 
goals help in performing the deduct ion^ the monitor will 
prompt the user for the correct value. If the value is 
known/ the user can enter it. However/ if the user does not 

know the value requested/ he can type a question mark (?) 

or a carriage return <cr>. The value of the attribute will 
remain rjOT KNOwN, 

If the user wants to know why the RITA monitor prompted 
him/ he can use the RITA command "why" followed by the 
semi-colon (;) and a carriage return <cr>. V'ihen a deduction 
has been completed and an attribute of a particular object 
has been deduced or found to be NOT KNOWN/ any later 
"deduce” command for the same attribute of the same object 
will fail to have any effect. The RITA system will not 

attempt to perform the deduction. If you desire to deduce 

the same attribute of the same object again/ the value of 

the attribute must be set to ^iOT KNOWN by the user. 

TYPE/ 
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' ^ . 



* delete all objects ana delete all goals? 



<c r> 



We no longer need the objects and goals in our 
program so we delete them. 

IF YOU WISH TO TERMINATE THE RITA SESSION AT THIS TIME 
TO THE SECTION OF THE TUTORIAL TITLED LEAVING A 
SESSION . 



RITA 

TURN 

RITA 
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XXIV* BUILT-IN FUNCTIONS 

A number of built-in functions are available in the RITA 
system, A function is a RITA command with a special 
Duroose. The purooses are performing arithmetic and string 
operations on values* The built* in functions give the user 
a specific Piece of information* There are currently 
seventeen built-in functions in the PITA system* Each 
function will be discussed and an example of each function 
will be shown* 



type. 

* object missiles <cr> 

quantity is5; <cr> 

* display absCquantity of missiles); 



<c r > 



An object was enterec with an object-name of missiles* 
The attribute was quantity* The value of the attribute was 
5. The RITA functions **abs” returns the absolute value of 
the value (i*e* 5)* The value must be a RITA number* A 
RITA number is a string consisting of one or more digits, 
optionally including a decimal point, optionally preceded by 
a plus or minus sign. and having optional leading and 
trailing blanks* Its magnitude must be less than 30 digits 
Iona* The following are equivalent and proper RITA numbers: 



5 

>5 
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I 



■ii'nf 

m 

< :■>-< :i 



, r,-A 



i 



4 



{ i 



4 JJb 







5 



+ 5 . 

5.0 

+ 5.0 
05 
+ 05 
05. 

+ 05. 

05.0 

+ 05.0 



1 f 


the value 


of the Guan t i 


t y of miss 


i 1 es had 


been -5/ 


the "abs" functi 


on wou Id have 


returned a 


five ( 5 ) 


• Remember 


a RITA 


number is 


a string of 


digits 


(0-9) . 


The string 


" five" 


is not 


equivalent to the str 


ing "5". 


The string 


"five" 


is not a 


RITA number • 









TYPE, 

* disolay clockC); <cr> 

The RITA function "clock" returns the current date and tine 
as a string of characters. Notice the parentheses in the 
RITA function "clock". They contain nothina and are typed 
consecutively-left then right oarenthesis-without a space. 

TYPE, 

♦object ship <c r> 

color is "grey", <cr> 

hue is "battleship"; <cr> 
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* set shade of ship to concat(hue of ship/'*-’*, <cr> 

color of ship); <cr> 

* display object ship; <cr> 

An object was enterec named "ship**. The attribute (i.e. 
color) had a value of "grey". The attribute (i.e. hue) had 
a value of " battleship "• The RITA command "set" gave the 
object (i.e. ship) an attribute (i.e. shade). The value was 
put together as a string by the RITA function "concat". 

Concatenation is a process of putting strings of 
characters together in a particular order. The RITA 

function "concat" took the value of the hue of the ship 
(i.e* battleship)/ put a dash (-) beside it and put the 
value of the color of the ship (i.e* grey) alongside those 
strings to form one strinq (i.e. battleship-grey). The 
value of the shade of the ship becomes "battleship-grey". 
The RITA command "display" demonstrates that the "concat" 
function was able to build the string "battleship-grey" and 
the "set" command out that value (i.e. battleship-grey) into 
the attribute (i.e. shade) of the object (i.e. ship). 

DO NOT TYPE/ 

* display evaMshade, ship); <cr> 

The RITA function "eval" evaluates the attribute (i.e. 
shade) of the object (i.e. ship) and returns the value (i.e. 
battleshio-grey). The first item must be an attribute (i.e. 
shade) and the second item must be an object (i.e. ship). 
If the value had not been set# the "eval" function would 
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have returned ”iNOT KNOWN 



(The built-in function 



e V a 1 



does not respond as exoected at the time of the writing of 
this tutorial.) 



TYPE, 



* object sailor 
temperature is **98.6"; 

* display f 1 oo r ( t empe r a t u r e 



<C r > 

<c r > 

of sailor); 



<c r > 



The object (i.e. sailor) was entered with an attribute 
(i.e. temperature) with a value (i.e* 98.6). The ** floor" 
function determines the value of the temperature of the 
sailor to see if the string is a RITA number. The "floor" 
function then returns the largest integer less than or equal 
to the RITA number. The value was "98.6". The value is a 
RITA number. The largest integer less than or equal to the 
RITA number (i.e. 98.6) is "98'*. The value "98" is returned 
by the "floor" function. If the value is not a RITA number, 
an error message is returned. 



TYPE, 

^ display object ship; <cr> 

WAIT FOR PRINTING AT TNe TERMINAL TO STOP. 



TYPE, 

* display index! "grey", "battleship -grey"); <cr> 

The function "index" takes the two values and checks to 
see that they are strings of charcters. Then the "index" 
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function returns the number of the position of the start of 
the first strinq (i.e. qrev) in the second string (i.e. 
batt leshiD-qrey), The first string ’’grey" is found in the 
second string '*ba 1 1 1 esh i p-grey ** . The position in the second 
strino (i,e* battleship-orey) where the first character 
(i.e. g) of the first strino (i.e. grey) appears is position 
Positions in a string of characters heoin with 
character position 1. 



type. 

^ display index(color of ship. shade of ship); <cr> 



The value of the color of ship is "grey". The value of 
the shade of the ship is "battleship-grey". The "index" 
function finds the first string (i.e. grey) in position 12 
of the second string (i.e. battleship- grey) as before. 



TYPE. 

* display i si i St ( ( "A-7". "F-a". "F-ia" ) ) ; <cr> 



The function "islist" evaluates the items 
(i.e.("A-7".”F-^"."F-l^")) to determine if the items are a 
list. A list is a left parenthesis. a number of values 
(strings or lists) separated by commas. and a right 
parenthesis. In the example, the first left parenthesis and 
the last right parenthesis enclose the items. The second 
left parenthesis and the next to the last right parenthesis 
are part of the list. The items "A-7". "F-^". ana "F-1^" 
are values. The commas separate the values in the list. 
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The "»sHst" function returns "TRUE" if the items are a list 
and "FALSE" otherwise. 

TYPE, 

* display islist("A-7","F-a","F-ia"); <cr> 

The items are not a list because a set of parentheses is 
missing. The one set of parentheses encloses the items 
belonging to the "islist" function. The function "islist" 
properly returns the error. 

type, 

* display object missiles; <cr> 

rtAIT FOR PRINTING AT THE TERMINAL TO STOP. 

type, 

* display isnum(quantity of missiles); <cr> 

The function "isnum" determines if the value (i.e. 5) of 
the attribute (i.e. quantity) of the object (i.e. missiles) 
is a RITA number. The function "isnum" returns the word 
"TRUE" if the value is a RITA number, otherwise, it returns 
"FALSE" . 

TYPE, 

* object plane <cr> 

speed is "SUPERSONIC"; <cr> 

* display lc(speed of plane); <cr> 

We entered an object (i.e. plane) with an attribute 
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(i.e. soeed) with a value (i.e. SUPERSONIC). The function 

"Ic" stands for lower case. It evaluates the value and 

determines whether it is a string of characters or not. If 
the value is a string of characters# each capital letter in 
the string is returned as a small letter, 

TYPE. 

* display lenqthCsoeed of plane); <cr> 

The function "length” evaluates the value (i.e* 

SUPERSONIC), If it is a string. the "length" function 

returns the number of characters in the string (i.e. 10). 

TYPE. 

* display 1 index("F-a% ( " A-7 " . "F-a " . "F- 1 ^ " ) ) ; <cr> 



The function "lindex" takes the first string (i.e. 
"F-a") and locates the position of that string of characters 
in the second item which must be a list. The function 
"lindex" finds that the first string of characters (i.e. 
"F-a”) is the second member of the list. "A-7" is the first 
member. ”F-4|” is the second member, and ”F-1^" is the third 
member of the list. If the first string of characters does 
not occur as a member of the list, the function "lindex" 
returns "FALSE". If the first string of characters does 
appear as a member of the list. the function "lindex" 
returns its position in the list. 



TYPE. 

* display max(quantity cf missiles. <cr> 
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temoerature of sailor); 



<c r> 



The ”ma)<**f maximumr function determines if the values of 
items are RITA numbers. If each value (i.e. 5^ 
98,6) is a RITA number/ the “max” function returns the 
laraest RITA number (i.e. 98.6). 

TYPE/ 

* display min(auantity of missiles/ <cr> 
temperature of sailor); <cr> 

The “min"/ minimum/ function determines if all the 
values of the items are RITA numbers. If each value (i.e. 
5/ 98.6) is a RITA number/ the “min” function returns the 
smallest RITA number (i.e. 5). 



TYPE/ 

* display mod(l0/3); <cr> 



The ”mod” function 
value two (i.e. 3) to 
Value one (i.e. 10) is 
remainder (i.e. 1)/ is 



evaluates value one (i.e. 10) and 
determine that both are RITA numbers, 
divided by value two (i.e. 3). The 
returned by the "mod” function. 



TYPE/ 

* display object missiles and display object ship; <cr> 



VnAIT for PRINTING AT THE TERMINAL TO STOP. 



TYPE/ 

* display nsubstr(12/ ”ba t t 1 esh i p-qr ey ” ) ; <cr> 
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The '*nsubstr** function finds a string of characters in a 
target string. The first item (i.e. 12) should evaluate to 
a Dositive integer - whole number larger than zero. The 
second item (i.e. should evaluate to a non^neqative 
integer - whole number larger than or equal to zero (0). 
The third item (i.e. battleshio-qrey) is the target string. 
The positive integer (i.e. 12) gives the starting position 
of the string of characters to be located in the target 
string. The non-negative number (i.e. ^) gives the length 
of the string of characters desired. Position 12 in the 
target string is the character **g**. The four (^) characters 
requested are ** g r e y". They are positions 12^ 13^ 14/ 15 
in the target string (i.e. ba t t 1 esh i n-gr ey ) . If the 
starting oosition requested exceeds the length of the target 
string/ the **nsubstr** function returns the empty string 
( " ” ) • 

TYPE. 

* display sused()? <cr> 

The ”sused” function returns the amount of memory used 
so far. Memory is any device into which a unit of 
information can be copiec. retained. and retrieved at a 
later time. The units of memory are words. A word is a set 
of characters which occupies one storage location. The word 
on the PDP-11 at Rand Corporation is two characters long. 
The “sused” function returns the amount of memory (in K 
words) used so far. K is a term for 1024. 
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TYPE, 



* disolav object ship; <cr> 

WAIT FOR PRINTING AT THE TERMINAL TO STOP. 

TYPE, 

* display ucCshade of ship); <cr> 

The "uc" function evaluates the item (i.e. shade of 
shio) to see if the value (i.e. bat t 1 esh i p-qrey ) is a string 
of characters. The "uc", upper case, function returns a 
capital letter for each small letter in the string. 
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XXV, arithmetic operators 



A RITA arithmetic operator is a basic action to be 
performed on two RITA numbers. The four arithmetic 

operators in the RITA system are + - * / 9 which represent 

addition, subtraction, multiplication, and division. 

Multiplication and division take precedence over addition 
and Subtraction, as in normal mathematical usage. To 
override this precedence, the user may group terms with 
angle brackets (<>). An arithmetic operator must be 
preceded and followed by a blank space. 

TYPE, 

*display3+2; <cr> 

The ’’display** command prints the information at the 
terminal. The arithmetic operator (i.e. +) adds value one 

(i.e. 3) and value two (i.e. 2). Remember both values must 

be RITA numbers. 

TYPE, 

* display object missiles? <cr> 

WAIT FOR PRINTING AT THE TERMINAL TO STOP. 

TYPE, 

^ display guantity of missiles • 2, <cr> 

The arithmetic operator subtraction (-) determines if 
the value (i.e. 5) of the guantity of missiles and the 2 
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are RITA nufrbers. Since both (i.e-. 5/ 2) are RITA numbers/ 
the subtraction is performed and the RITA number (i.e. 3) is 
returned. 

TYPE/ 

* set the Quantity of missiles to <cr> 

quantity of missiles ^ 2 } <cr> 

* display quantity of missiles/ <cr> 

The “set” command changes the value (i.e. 5) of the 

quantity of missiles to the value of the quantity of 
missiles multiplied by 2. Notice the value of the quantity 
of missiles has been changed to 10. The arithmetic operator 
multiplication (^) took the first value (i.e. 5) and 

multiplied it by the second value (i.e. 2). 

TYPE/ 

* display quantity of missiles / • 2> f <cr> 

The pair of angle brackets (<>) causes the arithmetic 
expression (i.e. ^ - 2) to be evaluated first. The 

arithmetic operator division (/) determines the value of the 
quantity of the missiles to be 10 and divides it be the 
value of 2 (i.e. ^ - 2). The RITA number 5 is returned. 
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X X V I • MATCHING A PATTERN IN A STRING OF CHARAfTPRS 



The RITA system has the capability to compare strings of 
characters to determine if one of the strings of characters 
is identical or containeo in another string of characters. 
For example^ the feature is essential for determining if the 
current value of a soecified attribute will make the premise 
of a rule true. The string of characters checked by the 
monitor must be exactly the same as the string of characters 
that comprise the specified value. 

Often we wish to have our RITA program check for strings 
of characters. However^ all of the characters are not 
always known* The RITA system has a feature whereby the 
user can give it a pattern specification. A pattern 
specification is a precise arrangement of characters. The 
RITA system can then/ without knowing the exact string of 
characters# locate an arrangement of characters - a pattern. 
A pattern specification may be used in the premise (If part) 
of a rule or goal. The RITA words "contains” or "does not 
contain" must also be part of the pattern specification. 



TYPE# 



* delete object plane; 

* delete object missiles; 

* delete object sailor; 

* display object ship; 



< c r > 

<c r > 



< c r > 



<C r> 



WAIT FOR PRINTING AT THE TERMINAL TO STOP. 
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TYPE 



* ru 1 e Da t t e rn <c r> 

If the shade of the shio contains <cr> 

{anything followed by **arey'*I <cr> 

Then set the service of the ship to **IMavy'‘ <cr> 
and RETURN SUCCESS; <cr> 

The pattern specifieo is “anything**^ which means exactly 
that. The oattern to be searched can begin with any 
character or characters. The RITA words ’* followed by‘* 
indicates that there is at least one more pattern to be 
matched. The word **grey“ enclosed by quotation marks is an 
exact string of characters to be matched (i.e. grey). The 
curly braces enclose the pattern specification. The word 
” Contains'* tells the RITA system that the oremise should be 
true if the following oattern is matched. The words **does 
not contain** would have been used if the desire was to have 
the oremise be true for cases other than when the pattern 
was matched. 

TYPE, 

^ run rule pattern; <cr> 

wait for PRINTING AT THE TERMINAL TO STOP. 

TYPE, 

* display object ship; <cr> 

The rule **oattern** was executed. The value of the shade 
of the shio was found to be **bat t 1 esh i p-grey ** . The premise 



(If Dart) of the rule was true. The pattern anything 
followed by "grey" was matched. The action of the rule was 
performed (i.e. the value of the service of the ship was set 
to "Navy".) 

type, 

*objectletter <cr> 

ziP”code is 939^40; <cr> 

*rulemail <cr> 

If the zip-code of the letter <cr> 
contains ("939a0"} <cr> 

Then set the destination of the letter to <cr> 
"I'^onterey" <cr> 
and RETURN SUCCESS; <cr> 

The pattern specification in the example above required 
the value (i.e. 939410) of the zip-code of the letter to be 
matched exactly. 

TYPE, 

*ru1eroute-mail <cr> 

If the zip-code of the letter <cr> 
contains ( "93" followed by some <cr> 

in "56789" followed by end) <cr> 

Then set the destination of the letter to "Cal" <cr> 
and RETURN SUCCESS; <cr> 

The pattern specification was the two numeric characters 
"93" followed by any numeric characters in the range 5 
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t h rough 9 . 


Then 


the 


next 


pattern could 


be 


any 


string 


o f 


characters 


• The 


rule 


wou Id check to 


see 


if the 


f i r s t 


t wo 


characters 


were ** 


93”. 


Then it would reauire 


a t 


least 


the 


next charac ter 


t o 


be 


a number between 5 


and 9 . 


Then 


the 


ru 1 e wou 1 d 


match 


any 


characters after 


i t 


found 


the 


last 


success i ve 


character 


i n 


the range 5 


t h rough 9 . 


The 


word 


"end" will 


cause 


the 


last 


characters to 


be matched 


• So , 


the 



following zip-codes woulc be matched: 

93500 

939^0 

93678 

The following zip*codes would not be matched: 

93^99 

93078 

93356 

The pattern spec i f i c a t i on in a rule or goal may be very 
general or Quite specific* The important idea in using a 
pattern s oec i f i c a t i on is the fact that patterns can be 
matched by knowing only their c h a r ac t e r i s t i c s . The exact 
string of characters may not be known. The other ways of 
buildina pattern specifications are numerous and will not be 
discussed in the tutorial. 

TYPE, 

* delete all objects; <cr> 

* delete all rules; <cr> 
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* delete all goals; <cr> 

The objects/ rules/ and goals in our RITA orogram 
longer needed so we've deleted them. 

IF YOU WISH TO TERMINATE THE RITA SESSION AT THIS TIME 
TO THE SECTION OF THE TUTORIAL TITLED LEAVING 
SESSION. 



are no 

TURN 
A RITA 
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XXVII 



ACCESSTMG OBJFCTS 



Information about the user’s RITA program is kept in the 
RITA objects. The object-name/ attributes^ and their values 
are also kept with the objects. The information about the 
objects must be enteredf changed/ or removed occasionally to 
keep the information current and correct. There are several 
RITA Commands to update object information, 

type, 

^ create a shio whose number is 66? <cr> 

* display object ship? <cr> 

The "create** command enters an object (i,e, ship). The 
oPjeCt has an attribute Ci,e, number). The attribute has a 
value (i,e, 66). 

TYPE/ 

* set the number of the ship to 67? <cr> 

♦displayobjectship? <cr> 

The "set" command allows the user to change the value 
(i,e. 66) of the number of the ship to 67, 

TYPE/ 

* put "America" into name of ship as first member? <cr> 

* display object ship? <cr> 

The "put" command sets the value of the attribute (i,e, 
name) of the object (i.e, ship) to "America". The attribute 



of the object must be a list. The attribute of the object 
must be a number of values. The phrase "first member" tells 
the RITA system where the value (i.e. America) belongs in 
the list. 



type. 

* out "Carrier" into name of ship as last member? <cr> 

* display object ship; <cr> 



The "put" command took the value (i.e. Carrier) and 
placed it as the last member in the list. Object ship has 
an attribute (i.e. name) which is a list. The list has two 
members. Member one is value "America" and member two is 
value "Carrier". 



type. 

* remove first member from name of ship; <cr> 

* display object ship; <cr> 



The "remove" command takes 
the first member of the list 
The list (i.e. name of ship) 

C a r r i e r ) . 

type. 

* remove last member from name 

* display object ship; 

The 

Ca r r i e r ) 



the 


value (i.e. 


America) of 


and 


deletes it 


from the 


list. 


has 


only one 


member 


(i.e. 



<c r> 



(i.e. 

name 



of ship; 

<C r > 

remove" command takes the last member 
and deletes it as a member of the list (i.e. 
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of shio). Other forms of the 



remove" command follow: 



00 NOT TYPE, 

* remove "America" from name of ship? <cr> 

* remove member "America" from name of ship; <cr> 

* remove every "Carrier" from name of ship; <cr> 

* remove first "America" from name of ship; <cr> 

type, 

* delete all objects anc delete all rules; <cr> 

IF YOU kNiSH TO TERMINATE THE RITA SESSION AT THIS TIME TURN 
TO THE SECTION OF THE TUTORIAL TITLED LEAVING A RITA 
SESSION. 

type, 

* load monitor. tew; <cr> 

wait for printing at the TERMINAL TO STOP. 

TYPE, 

* display all objects and display all goals; <cr> 

The next command to be discussed is the "deduce" command 
with a special ootion. We've loaded our external UNIX file 
"moni tor. tew". 

TYPE, 

* create a shio whose status is "underway"; <cr> 

* display object ship; <cr> 

wait FOR PRINTING AT THE TERMINAL TO STOP. 



TYPE, 



* deduce the oerformance of the shio (quietly]? <cr> 

* display object shio? <cr> 

The "create** command enters a value (i*e« underway) in 
the status of the ship. The **deduce** command calls the 
goal-directed monitor. The optional word ** quietly*’ enclosed 
in braces (M) causes the RITA system to provide no 
information while performing the deduction. 

TYPE, 

* delete all objects? <cr> 

^ delete all rules? <cr> 

* delete all goals? <cr> 

IF YOU WISH TO TERMINATE THE RITA SESSION AT THIS TIME TURN 
TO THE SECTION OF THE TUTORIAL TITLED LEAVING A RITA 



SESSION 



XXVIII. FXTERNAL U NI X PQPTS 



One o the objectives of the RITA system is to provide a 
facility for communicating from one computer to another* 
The RITA system provides for this capability by opening 
ports to the UNIX system, A port is a communication path. 
The port is given a name. Then information in our RITA 
program can be sent to and received from external computer 
systems by referring to the port by name. The RITA commands 
"send** and "receive" let the RITA system know that the 
information will be transferred via the specified port. The 
following example will show how a user can communicate 
information between two computer systems. 

TTPE, 

* object local-system <cr> 

status is "ready**; <cr> 

* object e X t e r n a 1 - s y s t em ; <cr> 



^ rulecommunicate <cr> 

If the status of the local-system is "ready" <cr> 

Then send "telnet isia** tooortl <cr> 

& receive next {anything followed <cr> 

by "EXEC" followed by <cr> 

anything} fromportl asthe <cr> 

response of e x t e r na 1 - sy s t em <cr> 

& display object e x t e rn a 1 -s y s t em ; <cr> 
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^ rule terminate 



<c r > 



If the response of the external-system is <cr> 
known <cr> 

Then send concat ( ** 1 ogout " ^ " tm" ) to portl <cr> 

& RETURN success; <cr> 

*run; <cr> 

An object (i.e. 1 oc a 1 -sy s t em ) was entered. Object 

“local-system'* was given an attribute (i.e. status). The 
attribute “status'* was given a value (i.e. ready). A second 
object (i.e. external-system) was entered. Object 
'* e X t e r n a 1 -sy s t em '* was given an attribute (i.e. response). 
The attribute “response" was given a value (i.e. EXEC). 
Rule "communicate" was entered. The If part of rule 
"communicate" checked to see if the value of the attribute 
(i.e. status) of the object (i.e. 1 oc a 1 -sy s t em ) was "ready". 

In this case rule “communicate" was true. The actions of 
the rule were then performed. 

The first action was the command “send". The RITA 
command "send" causes the information following the command 
(i.e. telnet isia) to be placed into a communication port 
(i.e. portl). A port is a path whereby communication can 
take place with an external computer. The information sent 
was "telnet isia". That command was interpreted by a UNIX 
shell program. It caused a connection to be opened to the 
host computer whose name was “isia". 

Age inf the “send" command causes information in the RITA 
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system to be transferred to the UNIX system. The place 
where the information is out is a port • a communication 
path. ;Ve named the port "portr’. The symbol means the 
same as the word **and'*. The next action taken was "receive" 
a pattern. The RITA command "receive" allows the user to 
transfer information from the UNIX system port. The pattern 
specified was anything followed by "EXEC" followed by 
anything. A string of charactrs that contained the four 
characters E X E C and any others would be matched. "Portl" 
is the name of the UNIX port where the information from the 
external computer will be put. The command "as the response 
of external-system" tells the RITA system to take the 
pattern that is received from "isia" via portl and set the 
value of the attribute (i.e. response) of the object (i.e. 
external-system) to that string of characters. 

Notice the value of the response of the e x t e r na 1 -s y s t em 
originally contained only four characters. Now after the 
"display object e x t e r na 1 - sy s t em " command the value of the 
response of the external-system contains numerous 
characters# not just four. Rule "terminate" checks to see 
that the value of the response of the external-system is 
known. That’s an indication that we were able to 
communicate with another computer. If the value of the 
response of the e x t e r na 1 - sy s t em had not been known# we would 
have known that our attempt at communication with the 
computer at "isia" had been fruitless. The Then part of rule 
"terminate" sends the characters "logout" and the conversion 
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symbols for the c a r r i age - re t u rn <cr> to oortl to be sent to 
The characters "logout** reoresent the command to 
terminate the connection to the computer at **isia*** Notice 
the '’RETURN SUCCESS** to make sure our program stopped* 

TYPE. 



delete 


al 1 


rules; 


<c r> 


delete 


al 1 


objects; 


<cr> 
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XXIX 



LEAVING A RITA SESSION 



There are three ways to leave the RITA system under 
normal conditions. To save our RITA program prior to 
exitinof do the following: 

TYPE. 



display 


al 1 


objects 


t o 


file well-done. tew; 


<c r> 


display 


a1 1 


rules to 


file 


well -done .tew; 


<c r > 


display 


al 1 


goals to 


f i 


1 e 


well -done .tew; 


<c r > 


exit; 












<c r > 



The "display” commancs put all the objects. rules and 
goals in an external file "well^done.tew". The RITA command 
"exit" causes the user to leave the RITA system ana to enter 
the UNIX operating system. (The end-of*file terminator, 
ctrl-d. performs the same function as the RITA command 
"exit",) The RITA system responds by printing the word 
"exiting" then a UNIX prcmpt-siqn (%). If we did not want 
to save our RITA program, the RITA command "exit" would have 
been used. However, the RITA command "display" would not 
have been used. 

DO NOT TYPE. 

* ex i t ; <c r> 

The third way of leavina a RITA session. under normal 
conditions. concerns itself with saving two files that the 
RITA system keeps. The RITA system keeps a "ufe. output" 



tile and a **rita,history** file. The '‘ufe.output** file 
contains a record of all the output that has been generated 
by the RITA session. The ”rita.history** file contains a 
record of all the major events that took place during a RITA 
session. Examples of the major events keot in the 
”rita. history” file follow: 

(1) Objects and rules loaded. 

( 2 ) Each t ime a rule or goal fires. 

To save the ^ufe. output” and ”rita. history” files after 
a RITA session# the RITA command ”exit save” would have been 
used . 

DO NOT TYPE# 

^exitsave; <cr> 

The ”ufe. output” file generated by the RITA system is 
useful if the user wants to check for error messages or 
would like to recall information about the output of RITA. 
The ”rita. history” file generated by the RITA system is 
useful if the user desires to know about the sequence of 
major events in his RITA program. 

Sections XXX and XXXI pertain to the UNIX operating 
system at The Rand Corporation. Use the appropriate 
procedures to log off the host computer that you are using. 



XXX • LOGOUT PROrmORFS 



After leaving the RITA systerr, we should log out of the UNIX 
operating system. There are several UNIX files that we have 
created while following this tutorial. If you have not 
completed all the sections of the tutorials skip to the 
command ”% logout". If you have comoleted all the sections 
of the tutorial do the following: 



TYPE, 



% rm na vy-b 1 ue . t ew 
% rm eye 1 i c . t ew 
% rm o rde r ed . t e w 
X rm ’monitor.tew 
X rm we I 1 -done . t ew 



<c r > 
<c r> 

<c r > 

<c r > 

<c r > 



The "rm” command removes the specified file from our 
user space. Remember the names of your files end with your 
initials. 

TYPE, 

X 1 ogou t <c r > 

The UNIX command "logout" lets the UNIX operating system 
know that we are terminating our use of the UNIX facilities. 
(Do not be concerned that the UNIX system asks for the user 



name again.) 



XXXI. DISCONNECTING THE II P _CLERM I N AL INTFPFACE MFSSaGE PPHCFSSOP) 



After logging out of the UNIX operating system on the 
PDP-11 at Rand Corporationr our connection should be closed 
prior to hanging up the telephone- 

TYPE, 

a)c <c r > 

The symbol tells the ARPANET that we wish to type a 

command- The ”c** is the command to close the connection 
from our terminal to the computer system- The TIP (Terminal 
Interface Message Processor) is still connected- If we 
desired to open a connection to a computer on the ARPANET, 
we could do so- However, to disconnect the TIP do the 
f o 1 lowing: 

HANG UP THE TELEPHONE- 

The tutorial has attempted to make a RITA newcomer as 
familiar with the RITA system as Possible in a brief time- 
i/*Jith the information that you have gained during the past 
few hours, you are ready to use the RITA Reference Manual- 
The following may be useful in locating the references 
referred to in this tutor ial- 

The RITA RpfArporp Manual is available f rom The Rand 
Corooration, Santa Monica, California, 90a06. The 

references UNTX for Beginners and A Tutorial — I ., n T rOCUCT 1 C . n , 
r h e U NTX Text Editor should be available at the location of 



the host co'T’DUter you are accessing to use the RITA system. 
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APPENDIX 0 - sample RITA PROGRAMS 



The major strenqths of the PITA system have been the 
Enqlish-like command language^ intelligent behavior^ and the 
facilities for communicating with external computer systems. 
Three sample programs have been written to demonstrate the 
usefulness of RITA programs acting sem i au t onomous 1 y to 
communicate with other comouter systems on the ARPANET. 

These programs depeno on each computer system being 
operational and capable of communicating with other computer 
systems when the RITA programs are executed. The sample 
programs do not incluoe features for handling the cases 
where the external computer systems are unable to respond. 
For programs that are critical the user should include rules 
in his prorams that handle the cases where the external 
comouter systems are unable to respond. 

The first RITA program opens a connection from a PDP-11 
computer at The Rand Corporation to a computer at the 
University of Southern California. The RITA program logs 
the user into the computer at USC and logs him out. The 
connection to the computer at USC is closed and the user is 
returned to the RITA system at The Rand Corporation. Once 
the program is started by the userr the RITA system handles 
all the communication protocols and reauires no human 
intervention. 

The second RITA program opens a connection from a PDP-11 
computer at The Rand Corporation to a different computer at 
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use. The user starts the RITA orogram runnina and the RITA 
system handles all the details of opening a connection to 
the comouter at USCf logging inr listing the files in a 
directory/ renaming a oarticular file/ logging out/ closing 
the connection to the computer at USC/ and returning to the 
computer at The Rand Corcoration, 

The third RITA program combines orograms one and two and 
performs the same functions as programs one and two did 
individually. However/ program three communicates with the 
two computers at USC simultaneously. 

The fact that a computer at The Rand Corporation and two 
comouters at the University of Southern California are used 
is not significant. RITA programs could be written to 
perfom the same functions with other computers on the 
ARPANET . 

To run the sample RITA programs# type them into the RITA 
system. Type the RITA commands "set trace ^/" and "run/" to 
start the programs running. The trace command provides the 
maximum information to the user during RITA program 
execut i on . 

The sample RITA programs and their explanations follow: 

example 1 



[OBJECTS:) 

OBJECT remote-system: 

login-orompt is "EXEC"/ 
orompt is "JOB"; 
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object demo 



state is ’’start”; 

OB JEC T DO r t ? : ; 

CRULES:! 

RULE hos t *c ; 

IF: the state of the demo is ’’check-telnet” 

i the response of the Dort2 is known 
THEN: receive next { the login-prompt of the remote- 

system} for 

60 seconds from port2 as the response of the port? 
i set the state of the demo to ’’check remote-host” 

& display object port2 
& display object demo; 

RULE command-c: 

IF: the state of the demo is ’’check remote-host” 

& the response of the port? is known 
THEN: send concat( ’’log experimental”/ ”T[”/ ”ex”f ”t[”/ 

”T[% ”tm” ) 

to port? 

& receive next { anyth inq followed by ’’JOB” 

followed by 

anything > for 15 seconds from port? as the 

r e s Don s e of the 
port? 

& display object port? 



i?a 



& delay 3 seconcs 

& set the state of the demo to '* logged in” 

& display object demo; 

RULE t e 1 ne t *c J 

IF: the state of the demo is "start” 

THEN: send "telnet i s i c '* to oort2 

& receive next { "Connections established,” 

followed by 

anything } for 15 seconds from port? as the 
response of the 
DO r t 2 

& display object port2 

& set the state of the demo to "check-telnet" 

& display object demo; 

RULE 1 ogou t -c • 

IF: the state of the demo is "logged in" 

THEN: send concat ("logout"^ "Tm") to port2 

K set the state of the demo to "logged out" 

& display object demo 
& return success; 

In the example program above/ rule "telnet*c" opens a 
connection from the RITA system at The Rand Corporation to a 
computer at USC with an ARPANET address of "isic"* Rule 
"host*c" allows the RITA system at The Rand Corporation to 
insure that a connection has been made to the proper 
computer. Identifying information from the computer at USC 
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I 




is received requesting that the user login. Rule “corrmand- 
c '* sends the login information to the computer at USC and 
receives information to confirm a successful login. Rule 
**loQOut*c" logs the user out of the computer at USC# closes 
the connection to the USC computer on the ARPANET# and 
returns the user to the RITA system at The Rand Corporation. 

example 2 



(OBJECTS:! 

OBJECT remote"system-a: 

login-prompt is '*EXEC'*# 
prompt is **J0B”; 

OBJECT demo*aJ 

state is ”start'*; 

OBJECT Dort I : ; 

(RULES:! 

RULE host: 

IF: the state of the demo-a is "check-telnet** 

I the response of the portl is known 
THEN: receive next i anything followed by "SYSTEM-A” 

followed by 

anything ) for 15 seconds from portl as the 

resDonse of the 
DO r t 1 

& set the state of the demo-a to ** check remote- 
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host 



& disolay object oortl 
& display object demo-a; 

RULE command: 

IF: the state of the demo-a is "check remo t e^hos t " 

& the response of the portl is known 
THEN: send concat ( "log nos-accat"/ "c77"^ "T("^ 

"T (»* , "tm" *) 

to portl 

& receive next { anything followed by "JOB" 

followed by 

anything } for 15 seconds from portl as the 

resDonse of the 
portl 

& display object portl 
^ delay 3 seconas 

& set the state of the demo-a to "logged in” 

& display object demo-a; 

RULE telnet: 

IF: the state of the demo-a is "start" 

THEN: send "telnet isia” to portl 

8r receive next { "Connections establisheci." 

foil owed b y 

anything > for 15 seconds from portl as the 

response of the 
portl 
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& disolay object portl 

^ set the state of the demo-a to check - telnet'* 
display object denno-a; 

RULE 1 oQou t i 

IF: the state of the demo-a is "finished" 

THEN: send concat ("logout"# "Tm") to portl 

& set the state of the demo-a to "logged out" 

^ display object demo-a 
& return suces s ; 

RULE directory: 

IF: the state of the demo-a is "logged in" 

THEN: send concat ("dir"# "T("# "tm") to portl 

& receive next { anything followed by 

"dueryl I I .demo; 3" 

followed by anything > for 60 seconds from portl as 

the 

response of Port I 
& display object portl 

set the state of the demo-a to "listing" 

& display object demo-a; 

RULE rename : 

IF: the state of the demo-a is "listing" 

^ the response of the portl is known 
THEN: send concat ("ren"# "t['*# "queryIII,demo#3"# "T{"# 

"querylll.gary;3"# "T("# "tm") to portl 

receive next ( anything followed by "#3" followed 



by 



anything } for 60 seconds fro^ Dortl as the 

response of 

po r t 1 

5 send concat ("dir**^ ”Tm”) to Dortl 

6 receive next { anything followed by ";3" followed 
by 

anything > for 60 seconds from Dortl as the 

resDonse of 

po r t 1 

& display object portl 

& send concat ("ren”, " que r y 1 1 1 • ga r y ; 3 ” ^ 

” t ( % 

"query I I I .demo; 3** , " t I" , "Tm”) to portl 
& set the state of the demo-a to "finished” 

& display object demo-a; 

In the examole program above^ the rule "telnet" opens a 
connection from the RITA system at The Rand Corporation to a 
computer at DSC with an ARPANET address of "isia"* Rule 

"host" allows the RITA system at The Rand Corporation to 

insure that a connection has been made to the proper 
computer. Identifying information from the computer at DSC 
is received requesting that the user login. Rule "command" 
sends the proper login commands and receives information 
from the computer at DSC that the login was successful. 
Rule "directory" causes the names of the user’s files at DSC 
to be listed. Rule "rename” chooses a particular file at 



129 




I 

I 

I 




use and changes its name* The names of the user's files are 
listed again to show that one of the names of the user's 
files has been changed. Rule "rename” also changes the name 
of the file back to its original name for convenience* Rule 
"logout” logs the user out of the computer at USC/ closes 
the connection on the ARPANET/ and returns the user to the 
RITA system at The Rand Corporation. 

EXAMPLES 



[OBJECTS:! 

OBJECT remote-system: 

login-prompt is "EXEC"/ 
prompt is "JOB"; 

OBJECT demo: 

state is "start"; 

OBJECT port2:; 

OBJECT remote-system-a: 

login-prompt is "EXEC"/ 
prompt is "JOB"; 

OBJECT demo-a: 

state is "start"; 

OBJECT portl:; 

[RULES: } 
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RULE host*c 



IF: the state of the demo is ’’check-telnet** 

& the resDonse of the oort2 is known 
THEN: receive next < the login-prompt of the 

system) for 

60 seconds from port2 as the resoonse of the 
& set the state of the demo to *’check remote 
& display object port? 

& disolay object demo; 

RULE command-c : 

IF: the state of the demo is ’’check remote-host” 

& the response of the port? is known 
THEN: send concat( **log expe r i men t a 1 ” r ”t[”r ”ex”f 

**tm” ) 

to port? 

& receive next { anything followed by 

followed by 

anything ) for 15 seconds from port? 

response of the 
port? 

& display object port? 

& delay 3 seconos 

& set the state of the demo to ”logged in” 

& display object demo; 

RULE t e 1 ne t -c ; 

IF: the state of the demo is ’’start” 



remote- 

port? 

-host” 



” t ( ” , 

••JOB” 
as the 



THEN: send "telnet isic" to oort2 

^ receive next { "Connections established,** 

foil owed by 

anything > for 15 seconds from oort2 as the 

response of the 
po r t 2 

8r display object port2 

& set the state of the demo to "check-telnet** 

& display object demo? 

RULE host? 

IF: the state of the demo-a is ** c hec k - 1 e 1 ne t ’* 

& the response cf the portl is known 
THEN: receive next { anything followed by **SYSTEK-A** 

followed by 

anything } for 15 seconds from portl as the 

response of the 
DO r t 1 

set the state of the demo-a to "check remote- 

host** 

& display object portl 
& display object demo-a? 



RULE command: 

IF: the state of the demo-a is ** 

& the response of the portl 
THEN: send concat ( "log nps-accat 



check remote-host 
i s known 

** , " r { ** , ** c 7 7 '* r 



H 



" t r , 
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Tm" ) 



to po r t 1 



& receive next { anything followed by 
foil owed by 

anything } for 15 seconds from portl as the 
response of the 
PO r t 1 

& display object portl 
^ delay 3 seconds 

& set the state of the demo-a to ’’logged in” 

& display object demo-a; 

RULE telnet: 

IF: the state of the demo-a is ’’start” 

THEN: send ”telnet isia” to portl 

& receive next { ’’Connections established.” 

followed by 

anything > for 15 seconds from portl as the 
response of the 
DO r t 1 

& display object portl 

& set the state of the demo-a to ’’check-telnet” 

& display object demo-a; 

RULE directory: 

IF: the state of the demo-a is ’’logged in” 

THEN: send concat (”dir”# ”T(”f ”Tm”) to portl 

& receive next { anything followed by 
”gueryIII.demo;3” 
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followed by anything } for 60 seconds f rom portl as 



the 

resDOnse of port 1 
& display object portl 

& set the state of the demo-a to "listing 
& display object demo~a; 



RULE rename! 

IF: the state of the demo-a is "listing" 

& the response of the portl is known 
THEN: send concat ("ren"^ "Tt", "guery 1 1 I .demo; 3" # "t(”, 

"QueryIII.gary;3", "t[", "tm") to portl 
& receive next { anything followed by ”;3" followed 



anything } for 60 seconds from portl as the 
response of 

DO r t 1 

& send concat ("dir", "t(", "tm") to oortl 
& receive next < anything followed by ";3" followed 



by 



o f 



anything } for 60 seconds from portl as the resonse 



DO r t 1 

& display object portl 

K send concat ("ren”, "T("/ " aue r y I 1 1 . ga ry ; 3 " , 



"query I 1 1 .demo; 3" , "t[", "tm”) to portl 

& set the state of the demo-a to "finished" 
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& display object demo-a; 



RULE logout: 

IF: the state of the demo-a is ** finished” 

& the state of the demo is "logged in” 

THEN: send concat ("logout”^ ”tm”) to oortl 

& send concat ("logout”# ”Tm”) to oort2 
^ set the state of the demo’-a to "logged out” 

& set the state of the demo to "logged out” 

& display object demo-a 
& display object demo 
& return success# 

The example program above communicates with two 
computers simultaneously* The rule "logout” was modified to 
insure that the RITA program terminated only after the user 
was ready to logout of both external computer systems* 

The method by which the RITA programs communicate with 
other computer systems depends on the user knowing the 
expected responses from the external computer systems and 
matching some of the characters in each response* The RITA 
system uses the "send" and "receive” commands to transfer 
information in and out of the RITA system* 

The user should be familiar enough with the RITA system# 
after working through Appendix A# to understand most of the 
specifics contained in the sample RITA programs. However# 
several items were not discussed in Appendix A. The ”Tm" 
represents the carriage- return and the "T(” represents the 



135 



ctrl-esc. Telnet is an ARPANET communication command to 
Oden a connection to another computer. 

After running the sample orograms and observing their 
outputf the user should be able to understand how the RITA 
system communicates with other computer systems. The 
objects are printed at the terminal or crt freouentiy to 
reinforce the idea that the RITA system is making 
intelligent decisions about what should be done next based 
uDon the contents of its dynamic database. 
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